Autodesk MCP

Autodesk Alias程序员界面（API）MCP服务器

MCP（模型上下文协议）服务器，为AI助手和编码代理提供可搜索的访问权限 Autodesk Alias程序员界面（API） 文档。它可以与 任何兼容MCP的客户端，包括Codex、Cursor、Claude Code等工具和类似环境。

⚠️ 免责声明： 这是一个非官方的个人项目。它不隶属于Autodesk股份有限公司，也不受Autodesk的认可或支持。

______________________________________________________________________

\[！注意\] 不是开发者？那完全没问题。 简而言之，该工具为AI助手（如Claude或Codex）提供了一种按需查找真实Autodesk Alias文档的方法，因此，当您向他们寻求构建Alias插件的帮助时，他们实际上可以立即获得正确的答案，而不是猜测或编造。不要把它想象成教科书，而更像是让人工智能在需要时直接与官方文档联系。

______________________________________________________________________

这个项目做什么

Autodesk Alias Programmers’Interfaces文档是从Autodesk官方帮助网站上抓取的，并以结构化JSON文件的形式存储在本地。在启动时，服务器加载生成的文档页面，剥离不必要的数据以节省内存，构建运行时感知部分的块，导出元数据，并创建搜索索引以进行快速相关性排名检索。

这个项目的目的很简单：

• 使Autodesk Alias文档可从MCP兼容的编码代理中使用
• 帮助这些代理检索正确的API引用和代码示例
• 在构建Alias插件时减少幻觉

______________________________________________________________________

为什么这些文件不包括在回购中

此存储库确实 不 直接发送Autodesk文档文件。

相反，回购提供：

• MCP服务器
• 抓取脚本
• 生成自己的文档数据集的本地工作流

这使项目保持可用，而无需在GitHub存储库中重新发布Autodesk文档内容。

______________________________________________________________________

文档生成

repo在这里包含一个scraper脚本：

• scraper_tavily/tavily_scraper.py

当前提供的抓取工作流程使用Tavily Extract API来检索和清理Alias文档页。 这是本项目中使用的重新抓取步骤：它读取文档页面URL的种子索引，并写入服务器使用的清理后的输出数据集。

基本刮擦流

1. 安装依赖项

pip install -r requirements.txt

1. 设置Tavily API密钥

建议：复制示例环境文件并添加Tavily API密钥。

cp .env.example .env

在Windows PowerShell上：

Copy-Item .env.example .env

然后编辑 .env:

TAVILY_API_KEY=your_api_key_here

刮板负载 .env 自动。您也可以直接在shell中设置变量。

命令提示符：

set TAVILY_API_KEY=your_api_key_here

PowerShell：

$env:TAVILY_API_KEY="your_api_key_here"

macOS/Linux：

export TAVILY_API_KEY=your_api_key_here

1. 使用提供的种子索引

scraper从以下位置读取其源页面列表：

• data/docs/index.json

此文件仅是URL清单。它包含页面GUID、标题和官方Autodesk帮助URL，而不是抓取的文档内容。

1. 先运行一个小测试刮取

python scraper_tavily/tavily_scraper.py --test

1. 进行全刮

python scraper_tavily/tavily_scraper.py

刮刀产生什么

刮取完成后，生成的数据集将在以下位置本地写入：

• data/docs_tavily/

该文件夹将包含：

• 每个文档页一个JSON文件
• 一 index.json 生成的语料库的摘要文件

生成的文件夹是MCP服务器在运行时读取的数据集。

______________________________________________________________________

服务器的工作原理

文档在本地生成后，服务器：

• 加载结构化页面JSON文件
• 从每个页面构建运行时块，以便更好地检索
• 保留代码块以进行以代码为中心的搜索
• 导出元数据，如标题、父页面上下文和代码块计数
• 在分块内容上构建基于BM25的搜索索引

这使得编码代理更容易：

• 按API名称搜索
• 按概念搜索
• 获取完整页面
• 检索包含实现工作示例的代码

______________________________________________________________________

插件构建要求

构建真正的Alias .plugin 文件要求：

• Microsoft Visual Studio C++构建工具，包括 nmake, cl.exe，以及 link.exe
• 访问Autodesk Alias API标题和库，通常由本地Autodesk Alias安装提供

此存储库确实 不 包括Autodesk Alias SDK/ODS头文件、库或示例。

MCP服务器可以帮助编码代理编写Alias插件，但编译这些插件需要在生成计算机上提供Alias API文件。

例如，本地Alias安装可能会提供以下文件：

• C:\Program Files\Autodesk\AliasAutoStudio2025.0\ODS\Common\include
• C:\Program Files\Autodesk\AliasAutoStudio2025.0\lib\libAliasCore.lib

在编译插件之前，设置 ALIAS_LOCATION 在插件中 Makefile 到本地Alias安装路径：

ALIAS_LOCATION=C:\Program Files\Autodesk\AliasAutoStudio2025.0

除非Autodesk的许可证明确允许重新分发，否则不要将Autodesk SDK/ODS文件复制到此存储库中。

______________________________________________________________________

可用工具

当前服务器公开了四个主要工具。

search_alias_docs(query, max_results=5, response_format="markdown")

使用节意识BM25排名搜索Alias文档。

示例：

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

get_doc_by_title(title, response_format="markdown")

按标题或部分标题检索文档页面的全部内容。

例子：

get_doc_by_title("AlCurve")

list_available_docs(response_format="markdown")

列出按类别参考和指南/概念分组的可用文档页面。

例子：

list_available_docs(response_format="json")

get_code_examples(topic, max_results=5, response_format="markdown")

搜索包含代码的块，并返回以代码为中心的摘录。这对于插件实现工作特别有用。

示例：

get_code_examples("plug-in")
get_code_examples("AlCurve", response_format="json")

______________________________________________________________________

\[！提示\] 构建插件？从包含的技能开始。 这 .agent/skills/alias-plugin-dev/SKILL.md 文件包含从分析中获得的编码代理技能 Autodesk自己的官方默认插件。它捕获了标准结构， Alias插件中使用的模式和约定，因此您的编码代理 不仅知道API，它还知道构建良好的插件应该如何 看看。如果你使用的是像Claude Code或Cursor这样的代理，请将其指向此 在开始构建之前，先将文件归档。

______________________________________________________________________

快速开始

1. 克隆仓库

git clone https://github.com/Roshan-RB/Autodesk_MCP.git
cd Autodesk_MCP

1. 安装依赖项

pip install -r requirements.txt

1. 确认种子URL索引存在于 data/docs/index.json

1. 使用提供的scraper生成本地文档数据集

python scraper_tavily/tavily_scraper.py --test
python scraper_tavily/tavily_scraper.py

1. 运行MCP服务器

python run_server.py

1. 运行回归检查

python test_server.py

1. 使用MCP检查器在本地检查服务器

npx @modelcontextprotocol/inspector --config .\inspector.json --server autodesk-alias-docs

提供的 inspector.json 用途 python run_server.py 并假设您在所需的Python环境处于活动状态的情况下从存储库根目录运行该命令。如果您更喜欢使用特定的虚拟环境，请编辑 inspector.json 指向该Python可执行文件。

______________________________________________________________________

MCP客户端配置示例

{
  "mcpServers": {
    "autodesk-alias-docs": {
      "command": "python",
      "args": ["run_server.py"]
    }
  }
}

从存储库根目录运行此操作，或替换 python 和 run_server.py 为您的本地设置提供绝对路径。

______________________________________________________________________

备注

• 生成的文档数据集是本地的，不会提交到存储库。
• 当前的实现针对本地Alias插件开发工作流进行了优化。
• 所有主要工具都支持机器友好的JSON输出 response_format="json".

______________________________________________________________________

许可证

此项目提供围绕Autodesk Alias文档的工具。文档内容本身仍受Autodesk使用和许可条款的约束。