AI导哈

思维导图服务

Coggle MCP Server是一个基于Model Context Protocol (MCP)的服务，用于在人工智能代理(LLMs)和思维导图平台Coggle之间进行交互。

  • by fsz-codeshop
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 fsz-codeshop/coggle-mcp-server

使用说明

Coggle MCP服务器

这 Coggle MCP服务器 是一个实现 模型上下文协议（MCP） 旨在调解人工智能代理（LLM）和思维导图平台之间的交互 科格尔.

使用TypeScript构建，旨在在 Cloudflare员工 基础设施使用 服务器发送事件（SSE） 请求：

🚀 功能（工具）

Coggle API公开了以下工具供AI使用：

  • coggle_list_diagrams：列出并检索属于用户的所有图表。
  • coggle_get_diagram：使用特定关系图的ID检索其完整的节点结构和信息。
  • coggle_create_diagram：在Coggle中创建空白思维导图/图表。
  • coggle_add_node：从父节点开始向图表中添加新的（子）节点。
  • coggle_update_node：修改现有节点的数据（文本、父节点或位置）。
  • coggle_delete_node：从图表中完全删除节点及其所有子节点。

📦 如何在本地安装和运行

1.要求

2.配置

  1. 安装依赖项：

    npm install

  2. 创建Coggle应用程序和身份验证变量： 首先，转到 Coggle开发工具 并创建一个新的客户端。 创建一个 .dev.vars 在项目的根文件夹中创建文件，并用您的应用程序凭据填充它：

    COGGLE_CLIENT_ID=your_client_id_here
COGGLE_CLIENT_SECRET=your_client_secret_here

  3. 生成API访问令牌： 设置后 .dev.vars 文件，使用提供的本地脚本执行完整的OAuth身份验证流程并生成永久令牌：

    npm run get-coggle-token

  4. 保存令牌（本地开发环境）： 将上一步生成的令牌添加到您的 .dev.vars 文件。 （可选）：如果你想通过身份验证来保护你的MCP服务器，你也可以添加一个自定义 BEARER_TOKEN 变量：

    COGGLE_API_TOKEN=your_access_token_here
BEARER_TOKEN=optional_custom_token_to_secure_mcp_server

3.运行服务器

通过以下方式在本地运行服务器 牧马人:

npm run dev

工人将从本地开始，通常在以下地址： http://localhost:8787。您可以拦截默认路由 http://localhost:8787/sse 在MCP连接中。

⚙️ 与Claude Desktop连接

一旦托管（或通过代理/网络隧道运行），您可以配置您的Claude Desktop应用程序，使其通过辅助CLI与Coggle进行本地通信(@modelcontextprotocol/client-fetch).将以下配置添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "coggle-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/client-fetch",
        "https://your-worker-url.workers.dev/sse"
      ]
    }
  }
}

☁️ 部署（Cloudflare）

部署将系统作为Cloudflare Worker进行推送。

  1. 通过Wrangler添加您的生产令牌 （只需执行一次）：

    npx wrangler secret put COGGLE_API_TOKEN --env production

  2. 部署到生产:

    npm run deploy

📚 其他文件

有关Coggle连接器和Worker如何设计的详细文档，请查看 /docs 文件夹：

相关 MCP