AR

adobe-rnd/da-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

5 stars 4 forks 质量 83 趋势 27Apache-2.0

A remote Model Context Protocol (MCP) server for Document Authoring (DA

概览

A remote Model Context Protocol (MCP) server for Document Authoring (DA). This server provides LLM assistants like Claude or ChatGPT with direct access to DA management operations. - : Complete set of tools for managing DA repositories, including preview/publish - : Deployable on Cloudflare Workers with global edge distribution - : Modern MCP transport protocol for remote servers - : Simple authentication by passing DA API tokens through Authorization header - : Error handling, logging, CORS support, and health checks - : Fully typed codebase for reliability and maintainability da_upload_media accepts files up to 4.5 MiB. URL downloads are stopped when the actual byte count exceeds this limit, even without a trustworthy Content-Length. Use the returned url to reference uploaded media when present; otherwise use the returned path. The server selects the storage backend automatically.

README

以下为原文 README 节选,完整内容请查看原文。

da-mcp

A remote Model Context Protocol (MCP) server for Document Authoring (DA). This server provides LLM assistants like Claude or ChatGPT with direct access to DA management operations.

Features

  • 17 DA Admin Tools: Complete set of tools for managing DA repositories, including preview/publish
  • Remote Access: Deployable on Cloudflare Workers with global edge distribution
  • Streamable HTTP: Modern MCP transport protocol for remote servers
  • Token Pass-through: Simple authentication by passing DA API tokens through Authorization header
  • Production Ready: Error handling, logging, CORS support, and health checks
  • TypeScript: Fully typed codebase for reliability and maintainability

Architecture

┌─────────────────┐
│   MCP Client    │
│ (Claude/Cursor) │
└────────┬────────┘
         │ Streamable HTTP
         │ + DA Token
         ↓
┌─────────────────────────┐
│  DA MCP                 │
│  ┌──────────────────┐   │
│  │   MCP Server     │   │
│  │   (17 Tools)     │   │
│  └──────────────────┘   │
└───────────┬─────────────┘
            │ HTTPS + Token
            ↓
┌─────────────────────────┐   ┌─────────────────────────┐
│  DA Admin API           │   │  AEM (HLX6) Admin API   │
│  (admin.da.live)        │   │  (api.aem.live)         │
└─────────────────────────┘   └─────────────────────────┘

Project Structure

src/
├── index.ts              # Cloudflare Worker entry point
├── mcp/
│   ├── server.ts         # McpServer factory with registerTool() + Zod schemas
│   └── handlers.ts       # Tool implementation handlers
├── admin/
│   ├── admin-client.ts   # Facade routing to legacy or HLX6 client
│   └── detect.ts         # HLX6 migration detection (cached in KV)
├── da-admin/
│   ├── client.ts         # Legacy DA Admin API client (admin.da.live)
│   └── types.ts          # Shared TypeScript types + IAdminClient interface
└── aem-admin/
    ├── client.ts         # HLX6 AEM Admin API client (api.aem.live)
    └── types.ts          # HLX6-specific response types

Available Tools

Tool Description
da_list_sources List sources and directories in a repository
da_get_source Get content of a specific source file
da_create_source Create a new source file
da_update_source Update an existing source file
da_delete_source Delete a source file
da_copy_content Copy content between locations
da_move_content Move content between locations
da_get_versions Get version history for a file
da_create_version Create a snapshot version of a file
da_get_version Get the content of a specific version of a file
da_lookup_media Lookup media references
da_lookup_fragment Lookup fragment references
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "da-live-admin": { "type": "streamable-http", "url": "https://da-mcp.adobeaem.workers.dev/mcp", "headers": { "Authorization": "Bearer YOUR_DA_USER_IMS_TOKEN" } } } }