amtb-mcp

amtb-mcp

用于与 AMTB 资源／工具交互的 MCP 服务

在 Claude Desktop 中使用

要在 Claude Desktop 中使用，请将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "amtb": {
      "command": "python",
      "args": ["{your_path}/amtb-mcp/run_mcp.py"]
    }
  }
}

快速入门

要求

• Python 3.13+（推荐）
• pip
• 可选：使用文档转换工具将 .doc 转换为 .docx 时，需要 LibreOffice（soffice）或 pywin32。

设置（Windows）

1. python -m venv .venv
2. ..venv\Scripts\Activate.ps1 # PowerShell 或 ..venv\Scripts\activate.bat # cmd

安装

• pip install -e .

本地运行

• 启动 MCP 服务（stdio 传输）：

  python run_mcp.py

  这会通过 stdio 暴露已实现的工具，供本地测试或 MCP 客户端（例如 Claude Desktop）使用。

• 也可以直接运行主模块：

  python main.py

测试

• 运行单元测试：

  python -m unittest discover -v

  或者，如果你更喜欢 pytest：

  pytest

直接使用工具（用于开发）

• 可在 Python 中调用封装函数进行快速检查，例如：

  python -c "from fetch_tool import fetch_amtb_menu; print(fetch_amtb_menu(write_files=False))"

  python -c "from main import get_amtb_categories; print(get_amtb_categories())"

说明

• fetch_amtb_menu 会在 out_dir 下写入 menu.json 和各类别文件（默认目录：amtb）。试运行时请使用 write_files=False。
• 下载和转换工具为可选项，可能需要额外的系统包并耗费时间。
• 开发时，请将新的工具模块放在 amtb-mcp/ 下，并在 main.py 中注册（或导入会在模块导入时调用 mcp.tool() 的模块）。

贡献

• 添加工具模块、编写测试并提交 PR。确保操作具备幂等性，并返回可序列化为 JSON 的 Pydantic 模型。

许可证

• 请参阅仓库根目录中的 LICENSE。