Autodesk MCP

🚀 Autodesk Alias API - MCP Server

這是一個MCP（模型上下文協議）服務器，它能讓AI助手直接在Claude Desktop、Cursor或任何支持MCP的客戶端工具中，對Autodesk Alias API文檔進行搜索訪問。

⚠️ 免責聲明：這是一個非官方的社區項目，與Autodesk公司沒有關聯，也未得到其認可或支持。

🚀 快速開始

1. 克隆並安裝依賴項

git clone https://github.com/Roshan-RB/Autodesk_MCP.git
cd Autodesk_MCP
pip install -r requirements.txt

2. 連接到你的AI工具 — 將服務器添加到你的MCP客戶端配置中：

{
  "mcpServers": {
    "autodesk-alias-docs": {
      "command": "/path/to/Autodesk_MCP/venv/Scripts/python.exe",
      "args": ["/path/to/Autodesk_MCP/run_server_v3.py"]
    }
  }
}

請將/path/to/Autodesk_MCP替換為你實際的安裝路徑。

✨ 主要特性

• 該服務器能讓AI助手在支持MCP的客戶端工具中對Autodesk Alias API文檔進行搜索訪問。
• 服務器啟動時會加載所有231個文檔頁面，去除不必要的數據以節省內存，並構建BM25搜索索引以實現快速、按相關性排序的檢索。
• 提供四個工具，均有Pydantic驗證的輸入、工具註釋和可選的JSON輸出。
• 提供兩個只讀資源，用於輕量級的編程訪問。

📦 安裝指南

1. 克隆並安裝依賴項

git clone https://github.com/Roshan-RB/Autodesk_MCP.git
cd Autodesk_MCP
pip install -r requirements.txt

2. 連接到你的AI工具 — 將服務器添加到你的MCP客戶端配置中：

{
  "mcpServers": {
    "autodesk-alias-docs": {
      "command": "/path/to/Autodesk_MCP/venv/Scripts/python.exe",
      "args": ["/path/to/Autodesk_MCP/run_server_v3.py"]
    }
  }
}

請將/path/to/Autodesk_MCP替換為你實際的安裝路徑。

💻 使用示例

基礎用法

search_alias_docs(query, max_results, response_format)

使用**BM25（Okapi）**排名在所有文檔中進行搜索。搜索結果包含相關性得分、匹配的術語和內容片段。對於精確標題匹配和包含代碼塊的頁面會應用啟發式提升。

示例：search_alias_docs("create NURBS surface")
示例：search_alias_docs("AlCurve", response_format="json")

get_doc_by_title(title)

通過文檔頁面的標題（支持部分匹配）檢索其完整內容。如果未找到匹配項，則返回標題建議。

示例：get_doc_by_title("AlCurve")

list_available_docs(limit, offset, category, response_format)

對所有文檔頁面進行分頁列出。支持按類別（class表示API參考，guide表示教程/示例）進行過濾，並返回分頁元數據（has_more，next_offset）。

示例：list_available_docs(category="class", limit=20)
示例：list_available_docs(offset=30, response_format="json")

get_code_examples(topic, max_results, response_format)

查找包含給定主題代碼示例的文檔頁面。將搜索結果過濾為僅包含代碼塊的頁面，非常適合查找示例插件和API使用模式。

示例：get_code_examples("plug-in")
示例：get_code_examples("NURBS", response_format="json")

📚 詳細文檔

MCP資源

兩個只讀資源，用於輕量級的編程訪問：

• docs://index — 所有頁面的完整JSON索引（標題、GUID、URL、是否包含代碼、類別）
• docs://stats — 語料庫摘要（總頁面數、類/指南/代碼數量）

文檔覆蓋範圍

抓取的數據集涵蓋231個頁面，包括：

• 類參考 — AlCurve、AlSurface、AlDagNode、AlUniverse等100多個類。
• 插件開發 — 瞬時、連續和命令歷史記錄插件。
• API示例 — 帶有解釋的完整代碼示例。
• 實現指南 — 插件的編譯、鏈接和設置。

後續計劃

• 語義檢索 — 用基於嵌入的搜索增強BM25，以獲得更好的上下文感知結果。
• 基於上下文的工具選擇 — 根據用戶意圖進行更智能的查詢路由。
• 插件開發 — 構建由該MCP服務器驅動的真實Autodesk Alias插件。

📄 許可證

本項目提供了一個訪問Autodesk Alias文檔的工具。文檔內容本身版權歸Autodesk公司所有。有關文檔許可，請參考Autodesk的使用條款。