APS MCP 身份验证示例

MCP 服务器的参考实现，集成 Autodesk Platform Services，覆盖以下所有组合：

• 服务器如何向 APS 进行身份验证

  • 2LO - 2-legged OAuth，应用级

  • 3LO - 3-legged OAuth，按用户

  • PKCE - 用于公共客户端的 3-legged OAuth，按用户

  • SSA - 安全服务账户，非人类身份

• MCP 客户端如何向服务器进行身份验证

  • 完全没有（STDIO）

  • 通过外部身份提供方

  • 通过 OAuth 代理服务

所有基于 HTTP 的示例均面向 2026-07-28 MCP 规范修订版，并基于拆分后的 MCP TypeScript SDK v2（@modelcontextprotocol/{server,express,node}）。该规范要求 MCP 服务器充当 OAuth 2.1 的 资源服务器，由专用授权服务器支持；在标识 MCP 客户端时，更倾向于使用 Client ID Metadata Documents (CIMD) 而非 Dynamic Client Registration。

每个示例都提供相同的 MCP 工具，均在 shared/ 中实现一次并在各处复用：list-projects（通过 Data Management API 获取 hubs 和 projects）和 list-contents（获取某个项目顶层的文件夹，或某个具体文件夹的内容）。

所有示例共用的设置

1. 在 https://aps.autodesk.com/myapps 注册一个 APS 应用（如果你会使用任何 3LO 示例，请选择 传统 Web 应用（Traditional Web App）；如果只使用 2LO，只需 Server-to-Server / API-key 风格的应用即可）。对于 SSA，还需要另外创建一个 Secure Service Account 并注册其公钥——参见 SSA 指南。

2. 在仓库根目录执行 npm install——这是一个 npm workspaces 项目，一条安装命令即可解析 shared 和所有四个 TypeScript 服务器。

3. 复制 .env.example 为 .env，并为你选择的 APS_AUTH_MODE 填写适当的值，然后在相应文件夹内用 npm start 运行任意 TypeScript 示例（或在根目录运行 npm run start -w <package-name>）。

4. simple-oauth-proxy 是一个单独的 Python/FastMCP 服务——其设置请参阅它自己的 README；只有在尝试 aps-mcp-server-remote-proxy 时才需要它。

Related MCP server: Devcon MCP Workshop 2026

关于范围的说明

这些是教学示例，优化用于一口气读完。有几处为了简洁刻意做了简化，并已在相关 README 中标注（例如仅保存在内存中、没有水平扩展方案；OAuth 代理示例中，CIMD 获取方式简化且未对 SSRF 做完整加固，等等）。请不要在未阅读这些注意事项的情况下，将安全性相关的部分直接复制到生产环境。