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的种子索引，并写入服务器使用的清理后的输出数据集。
基本刮擦流
- 安装依赖项
pip install -r requirements.txt- 设置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_herePowerShell：
$env:TAVILY_API_KEY="your_api_key_here"macOS/Linux：
export TAVILY_API_KEY=your_api_key_here- 使用提供的种子索引
scraper从以下位置读取其源页面列表：
data/docs/index.json
此文件仅是URL清单。它包含页面GUID、标题和官方Autodesk帮助URL，而不是抓取的文档内容。
- 先运行一个小测试刮取
python scraper_tavily/tavily_scraper.py --test- 进行全刮
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\includeC:\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这样的代理，请将其指向此 在开始构建之前，先将文件归档。______________________________________________________________________
快速开始
- 克隆仓库
git clone https://github.com/Roshan-RB/Autodesk_MCP.git
cd Autodesk_MCP- 安装依赖项
pip install -r requirements.txt- 确认种子URL索引存在于
data/docs/index.json
- 使用提供的scraper生成本地文档数据集
python scraper_tavily/tavily_scraper.py --test
python scraper_tavily/tavily_scraper.py- 运行MCP服务器
python run_server.py- 运行回归检查
python test_server.py- 使用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使用和许可条款的约束。