AI导哈

Cardhop本地服务

为Cardhop提供本地macOS MCP服务器，支持通过AppleScript和URL方案进行集成。

  • by gaelic-ghost
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 gaelic-ghost/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+传输命令的本地准备状态

更新指南

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

  • "<existing name> <changed fields>"
  • 例子： 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 .

相关 MCP