Cardhop MCP

cardhop mcp

Cardhop的本地macOS MCP服务器，使用有记录的Cardhop集成路由：

• AppleScript： tell application "Cardhop" to parse sentence "..."
• URL方案： x-cardhop://parse?s=...

update 有意将其实现为自由形式的别名 parse （没有未记录的路线）。

需求

• macOS
• uv
• Python 3.13+

安装依赖项

uv sync

在本地运行

uv run python app/server.py

Codex MCP客户端配置（示例）

将此服务器块添加到Codex配置中($CODEX_HOME/config.toml，通常 ~/.codex/config.toml):

[mcp_servers.cardhop]
enabled = true
command = "bash"
args = ["-lc", "cd /absolute/path/to/cardhop-mcp && PYTHONPATH=. uv run python app/server.py"]

暴露的MCP工具

• schema：返回锁定的架构包(cardhop.mcp.tools.v1)
• parse：向Cardhop发送句子(auto|applescript|url_scheme，可选 add_immediately, dry_run)
• add：用于解析的便利包装器 add_immediately=true
• update：解析语义的自由形式更新指南
• healthcheck：Cardhop+传输命令的本地准备状态

更新指南

为了获得最佳的更新行为，请使用此表单中的自由形式说明：

• " "
• 例子： Jane Doe new email jane@acme.com mobile 555-123-4567

运行验证检查

uv run pytest
uv run ruff check .
uv run mypy .

项目布局

• app/server.py：FastMCP服务器入口点
• app/tools.py：Cardhop模式和工具逻辑
• tests/test_tools.py：解析、传输和健康行为的单元测试
• pyproject.toml：项目元数据和依赖关系

开发快速入门

uv sync
uv run pytest
uv run ruff check .
uv run mypy .