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.配置
- 安装依赖项：
npm install- 创建Coggle应用程序和身份验证变量：
首先，转到 Coggle开发工具 并创建一个新的客户端。 创建一个 .dev.vars 在项目的根文件夹中创建文件，并用您的应用程序凭据填充它：
COGGLE_CLIENT_ID=your_client_id_here
COGGLE_CLIENT_SECRET=your_client_secret_here- 生成API访问令牌：
设置后 .dev.vars 文件，使用提供的本地脚本执行完整的OAuth身份验证流程并生成永久令牌：
npm run get-coggle-token- 保存令牌（本地开发环境）：
将上一步生成的令牌添加到您的 .dev.vars 文件。 *（可选）*：如果你想通过身份验证来保护你的MCP服务器，你也可以添加一个自定义 BEARER_TOKEN 变量：
COGGLE_API_TOKEN=your_access_token_here
BEARER_TOKEN=optional_custom_token_to_secure_mcp_server3.运行服务器
通过以下方式在本地运行服务器 牧马人:
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进行推送。
- 通过Wrangler添加您的生产令牌 （只需执行一次）：
npx wrangler secret put COGGLE_API_TOKEN --env production- 部署到生产:
npm run deploy📚 其他文件
有关Coggle连接器和Worker如何设计的详细文档，请查看 /docs 文件夹：