FusionCHMIngest MCP 服务端

为了帮助你快速上手，该 MCP 服务器具备以下特性与使用方法。

• 项目简介

  • 该仓库实现了一个 MCP 服务器，核心职责是向 LLM 客户端暴露资源、工具和提示模板等能力，便于 AI 代理在开发过程中查询 Fusion360 API 文档、获取类/方法信息和代码示例，并在需要时执行语义检索。

• 主要功能点

  • 语义搜索：通过向量数据库查询 Fusion360 API 文档，返回相关片段和摘要。
  • 文档获取：提供获取指定 API 类的完整文档和代码示例的能力。
  • 类列表与过滤：列出所有可用的 API 类，并支持简单过滤。
  • MCP 服务器接入：实现 list_tools 与 call_tool，遵循 MCP 的工具暴露模式，方便整合到 Claude、Cursor、VS Code Copilot 等客户端。
  • 向量存储与嵌入：借助 chromadb 存储文档片段的向量嵌入，支持向量检索与管理。
  • CLI 集成：可通过 fusionchmingest mcp 启动 MCP 服务器，与现有 CLI / 流水线无缝协作。

• 安装步骤

  • 确保 Python 3.11 及以上环境。
  • 安装依赖并以开发模式安装本包：
    • 在仓库根目录执行：pip install -e .
  • 安装 MCP 运行依赖（如未安装 MCP 库，请通过 pip 安装：pip install mcp）。
  • 如需本地测试，请确保系统中有 Chromadb、Sentence Embeddings 等依赖（README 中有详细依赖清单）。

• 服务器配置（MCP 客户端使用，示例为常见的客户端配置形式） 为了让 MCP 客户端与服务器建立连接，需在客户端提供以下配置信息： { "mcpServers": { "fusion360-api": { "command": "fusionchmingest", "args": ["mcp"] } } } 说明：

  • server name: fusion360-api（用于客户端标识该 MCP 服务的名称）
  • command: fusionchmingest（运行入口命令，CLI 入口可通过该命令启动服务）
  • args: ["mcp"]（指定启动 MCP 服务模式，服务器端实现中通过 fusionchmingest mcp 启动）

• 基本使用方法

  • 启动 MCP 服务器：在命令行执行 fusionchmingest mcp
  • 与客户端连接：在你的 MCP 客户端（如 Claude/ Cursor/ VS Code Copilot 等）中，将配置设置为上面的示例 JSON，并指向启动的服务器。
  • 常用操作（客户端侧）：
    • 通过服务器暴露的工具执行语义搜索、获取类文档、获取代码示例、列出类等。
    • 如遇到网络或依赖问题，请确保已正确安装 mcp 及所需的向量数据库运行环境。