Kobo MCP Server

KoboToolbox MCP服务器

连接的MCP（模型上下文协议）服务器 Kobo工具箱 Claude Desktop、Claude Code和Microsoft Copilot Studio等人工智能助手。

特性

• 双模式支持：同时用作REST API和MCP协议服务器
• 完整的KoboToolbox集成：列出项目、查询提交、获取表单架构、聚合数据
• 多客户端支持：Claude Desktop、Claude Code、Copilot Studio和任何兼容MCP的客户端

可用工具

快速开始

1.克隆和安装

git clone https://github.com/Admin-PSS/kobo-mcp-server.git
cd kobo-mcp-server
pip install -r requirements.txt

2.配置环境

创建一个 .env 文件：

KOBO_TOKEN=your-kobo-api-token
KOBO_BASE=https://kf.kobotoolbox.org/api/v2

从KoboToolbox获取您的API令牌： 帐户设置>安全>API密钥

3.运行服务器

REST API模式：

python server.py
# or
uvicorn server:app --reload --port 8000

MCP stdio模式（适用于克劳德桌面）：

python mcp_server.py

客户端配置

克劳德桌面

增添 claude_desktop_config.json:

窗户： %APPDATA%\Claude\claude_desktop_config.json macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "kobo": {
      "command": "python",
      "args": ["C:\\path\\to\\mcp_server.py"],
      "env": {
        "KOBO_TOKEN": "your-kobo-api-token",
        "KOBO_BASE": "https://kf.kobotoolbox.org/api/v2"
      }
    }
  }
}

克劳德代码

claude mcp add kobo python /path/to/mcp_server.py -e KOBO_TOKEN=your-token

微软复制品工作室

从部署的服务器导入OpenAPI规范：

https://your-server-url/openapi.json

REST API端点

基于HTTP/SSE的MCP

对于远程MCP客户端：

• SSE流： GET /mcp/sse
• 信息： POST /mcp/message
• 工具列表： GET /mcp/tools

环境变量

许可证

麻省理工学院

链接

• Kobo工具箱
• MCP协议