AI导哈

Umbraco MCP服务器

Umbraco MCP服务器是一个为Umbraco CMS实现的模型上下文协议服务器，允许LLMs通过标准化接口访问和操作Umbraco内容。

  • by HappydanceLabs
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 HappydanceLabs/umbraco-mcp-server

使用说明

Umbraco MCP服务器

Umbraco CMS的模型上下文协议（MCP）服务器实现，允许LLM通过标准化接口访问和操纵Umbraco内容。

概述

该存储库提供了一个连接到Umbraco CMS的模型上下文协议服务器，使像Claude这样的AI模型能够：

  • 从Umbraco检索内容
  • 针对Umbraco Management API执行操作
  • 访问文档类型、媒体和其他Umbraco资源
  • 通过标准化的工具界面执行操作

安装

# Clone the repository
git clone https://github.com/HappydanceLabs/umbraco-mcp-server.git

# Navigate to the project directory
cd umbraco-mcp-server

# Install dependencies
npm install

# Generate Umbraco API types
npm run generate:umbraco

# Start the development server
npm run dev

服务器将在以下时间可用 http://localhost:8787/

连接MCP检查器

探索MCP API并测试可用资源和工具：

  1. 启动MCP检查器：

    npm run mcp:inspector

  2. 在检查器界面中，将传输类型切换为 SSE 并进入 http://localhost:8787/mcp 作为URL。

  3. 单击“连接”并按照任何身份验证提示进行操作。

  4. 连接后，您可以列出并调用可用的资源和工具。

连接到克劳德桌面

要将此MCP服务器与Claude一起使用：

  1. 安装Claude Desktop并按照以下步骤操作 Anthropic的MCP快速入门

  2. 在Claude Desktop中，转到“设置”>“开发人员”>“编辑配置”

  3. 将配置替换为：

{
  "mcpServers": {
    "umbraco": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/mcp"
      ]
    }
  }
}
  1. 重新启动Claude，您将能够直接从Claude使用Umbraco工具。

部署

  1. 为OAuth创建KV命名空间：

    npx wrangler kv namespace create OAUTH_KV

  2. 将KV命名空间ID添加到 wrangler.jsonc

  3. 部署到Cloudflare Workers：

    npm run deploy

  4. 更新您的Claude配置以使用您部署的URL：

    {
  "mcpServers": {
    "umbraco": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-worker-url.workers.dev/sse"
      ]
    }
  }
}

项目结构

  • /src/api：Umbraco API客户端和接口
  • /src/resources：用于读取Umbraco数据的MCP资源实现
  • /src/tools：用于执行操作的MCP工具实现
  • /src/helpers：实用函数和共享代码
  • /src/types：TypeScript类型定义

发展

该项目使用 模型上下文协议TypeScript SDK 和 Cloudflare代理SDK 根据MCP规范实施资源和工具。托管并部署在Cloudflare Worker上。

有关MCP协议的更多信息，请参阅 官方文件.

调试

如果您遇到问题：

# Test direct connection to the MCP server
npx mcp-remote http://localhost:8787/sse

# Clear MCP authentication cache if needed
rm -rf ~/.mcp-auth

相关 MCP