一个用于文档创作（DA）的远程模型上下文协议（MCP）服务器。该服务器为 Claude 或 ChatGPT 等 LLM 助手提供对 DA 管理操作的直接访问。
10 个 DA 管理工具：用于管理 DA 仓库的完整工具集
远程访问：可部署在 Cloudflare Workers 上，具有全球边缘分发能力
Streamable HTTP：适用于远程服务器的现代 MCP 传输协议
令牌透传：通过 Authorization 请求头传递 DA API 令牌的简单认证方式
生产就绪：错误处理、日志记录、CORS 支持和健康检查
TypeScript：完全类型化的代码库，确保可靠性和可维护性
Related MCP server: Core Content Services MCP Server
┌─────────────────┐
│ MCP Client │
│ (Claude/Cursor) │
└────────┬────────┘
│ Streamable HTTP
│ + DA Token
↓
┌─────────────────────────┐
│ DA MCP │
│ ┌──────────────────┐ │
│ │ MCP Server │ │
│ │ (10 Tools) │ │
│ └──────────────────┘ │
└───────────┬─────────────┘
│ HTTPS + Token
↓
┌─────────────────────────┐
│ DA Admin API │
│ (admin.da.live) │
└─────────────────────────┘src/
├── index.ts # Cloudflare Worker entry point
├── mcp/
│ ├── server.ts # MCP server initialization
│ ├── tools.ts # Tool definitions (schemas)
│ └── handlers.ts # Tool implementation handlers
└── da-admin/
├── client.ts # DA Admin API client
└── types.ts # TypeScript types工具 | 描述 |
| 列出仓库中的源和目录 |
| 获取特定源文件的内容 |
| 创建新的源文件 |
| 更新现有的源文件 |
| 删除源文件 |
| 在位置之间复制内容 |
| 在位置之间移动内容 |
| 获取文件的版本历史 |
| 创建文件的快照版本 |
| 获取文件特定版本的内容 |
| 查找媒体引用 |
| 查找片段引用 |
Node.js 18+ 和 npm
Cloudflare 账户（免费套餐即可）
已安装 Wrangler CLI（npm install -g wrangler）
DA Admin API 令牌
克隆并安装依赖：
git clone <repository-url>
cd da-mcp
npm install配置 Wrangler：
如有需要，编辑 wrangler.toml 以自定义部署设置。
在本地运行服务器并支持热重载：
npm run dev服务器将在 http://localhost:8787 上可用。
健康检查： http://localhost:8787/health
MCP 端点： http://localhost:8787/mcp
启动本地服务器：npm run dev
配置连接：
类型：Streamable HTTP
URL：http://localhost:8787/mcp
请求头：Authorization: Bearer YOUR_DA_TOKEN
# Deploy to production
npm run deploy
# Or deploy to development environment
wrangler deploy --env development部署后，您的 MCP 服务器可通过以下地址访问：
直接 MCP 端点：https://da-mcp.adobeaem.workers.dev/mcp
通过 AEM API 路由器进行 IMS 认证：https://mcp.adobeaemcloud.com/adobe/mcp/da
（支持 Adobe IMS 登录。有关详细信息，请参阅下面的认证部分。）
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或等效位置：
{
"mcpServers": {
"da-live-admin": {
"type": "streamable-http",
"url": "https://da-mcp.adobeaem.workers.dev/mcp",
"headers": {
"Authorization": "Bearer YOUR_DA_USER_IMS_TOKEN"
}
}
}
}添加到 .vscode/mcp.json 或 Cursor 设置中：
{
"mcpServers": {
"da-admin-mcp-direct": {
"url": "https://da-mcp.adobeaem.workers.dev/mcp",
"headers": {
"Authorization": "Bearer YOUR_DA_USER_IMS_TOKEN"
}
},
"da-prod-mcp": {
"url": "https://mcp.adobeaemcloud.com/adobe/mcp/da"
}
}
}服务器使用简单的令牌透传认证：
客户端在 Authorization 请求头中发送 DA Admin API 令牌
服务器提取令牌并将其传递给 DA Admin API
所有对 DA Admin API 的请求都使用此令牌
Authorization 请求头格式：
Authorization: Bearer YOUR_DA_USER_IMS_TOKEN或简写为：
Authorization: YOUR_DA_USER_IMS_TOKEN注意： 如果您通过 API 路由器的公共（已认证）URL 访问 API，IMS（Adobe Identity Management Service）登录将由 AEM API 路由器自动处理。在这种情况下，您无需在 Authorization 请求头中提供 DA Admin API 令牌——IMS 登录流程将为您提供认证。
配置完成后，您可以要求您的 AI 助手执行 DA 操作：
Claude, can you list all the sources in the adobe/my-docs repository?Please get the content of docs/index.md from the adobe/my-docs repository.Create a new file at docs/new-page.md with some markdown content.GET /health返回服务器状态的健康检查端点。
响应：
{
"status": "healthy",
"service": "da-mcp",
"version": "1.0.0",
"environment": "production",
"timestamp": "2025-01-07T12:00:00.000Z"
}POST /mcp用于工具执行的 MCP 协议端点。需要带有 DA Admin API 令牌的 Authorization 请求头。
所有工具都包含全面的错误处理：
401 未授权：DA Admin 令牌缺失或无效
404 未找到：无效的端点
408 超时：请求耗时超过 30 秒
500 内部错误：带有详细信息的服务器端错误
错误经过格式化，便于 LLM 客户端理解。
服务器将重要事件和错误记录到 Cloudflare Workers 日志中：
# View logs in real-time
wrangler tail
# View logs for specific environment
wrangler tail --env production监控您部署的 Worker：
Cloudflare Dashboard：查看调用、错误和性能
Wrangler Tail：实时日志（wrangler tail）
健康检查端点：定期在 /health 进行健康检查
欢迎贡献！请：
Fork 仓库
创建功能分支
进行更改并附带测试
提交 Pull Request
This server cannot be deployed
Provides capabilities that let LLM agents perform a range of infrastructure management tasks.
Manage ConfigDirector feature flags, remote configs, and targeting rules from AI assistants.
Find, write, publish and check pages and API references in your DeveloperHub docs from an AI client
Read and write KukGit repositories, files, issues and pull requests from an AI assistant.
