AI导哈

KoboToolbox MCP服务器

一个连接KoboToolbox与AI助手的MCP服务器，支持REST API和MCP协议，适用于数据查询和集成场景。

  • by PYI-SOE-LTD
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Admin-PSS/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的客户端

可用工具

工具 说明
listProjects 列出所有KoboToolbox项目
getProjectSummary 获取项目的提交次数
getProjectSchema 获取表单问题/字段
queryProjectData 使用筛选器查询提交
getCountsBy 按字段汇总计数
getTimeWindowSummary 日期范围摘要

快速开始

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端点

端点 方法 描述
/actions/listProjects GET 列出所有项目
/actions/getProjectSummary GET 获取提交次数
/actions/getProjectSchema GET 获取表单字段
/actions/queryProjectData POST 带过滤器的查询
/actions/getCountsBy GET 按字段聚合
/actions/getTimeWindowSummary GET 日期范围摘要

基于HTTP/SSE的MCP

对于远程MCP客户端：

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

环境变量

变量 必需 默认值
KOBO_TOKEN 是 -
KOBO_BASE 没有 https://kf.kobotoolbox.org/api/v2

许可证

麻省理工学院

链接

相关 MCP