AI导哈

Kobo调查管理服务

一个用于KoboToolbox的MCP服务器，支持通过Claude部署调查问卷并获取提交数据。

  • by bbdaniels
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 bbdaniels/kobo-mcp

使用说明

Kobo MCP

KoboToolbox的MCP服务器，使Claude能够部署调查和获取提交。

文档

需要Python 3.10+

Claude Code快速入门

设置KoboToolbox API令牌，然后使用单个命令注册服务器：

export KOBO_API_TOKEN="your-token-here"
claude mcp add kobotoolbox -- env KOBO_API_TOKEN=$KOBO_API_TOKEN uvx kobo-mcp

对于欧盟服务器，也传递服务器URL：

export KOBO_API_TOKEN="your-token-here"
claude mcp add kobotoolbox -- env KOBO_API_TOKEN=$KOBO_API_TOKEN KOBO_SERVER=https://eu.kobotoolbox.org uvx kobo-mcp

就是这样——重启Claude Code，您就可以直接从CLI开始管理KoboToolbox调查。

若要获取API令牌，请转到 Kobo工具箱 ->帐户设置->安全性->API密钥。

特性

  • 信息 -获取帮助并发现工作流程（翻译、部署、数据导出）
  • list_forms -列出所有KoboToolbox调查
  • get_form -获取详细的表单结构（JSON）
  • resolve_form -查找Enketo提交URL的UID表单
  • 导出表单 -将现有表单下载为XLSForm（.xlsx）
  • get_提交 -使用可选筛选获取调查回复
  • 部署表单 -上传和部署新的XLSForm文件
  • replace_form -更新现有表单，保留提交内容
  • set_validation_status -批准、拒绝或标记提交
  • 导出数据 -将数据导出为CSV或Excel

安装

pip install kobo-mcp

或者直接使用uvx运行（无需安装）：

uvx kobo-mcp

配置

手动JSON配置

如果您更喜欢手动配置Claude而不是使用 claude mcp add，添加到 ~/.claude.json:

{
  "mcpServers": {
    "kobotoolbox": {
      "type": "stdio",
      "command": "uvx",
      "args": ["kobo-mcp"],
      "env": {
        "KOBO_API_TOKEN": "your-token-here"
      }
    }
  }
}

对于欧盟服务器，添加 "KOBO_SERVER": "https://eu.kobotoolbox.org" 到 env 块。

与Claude Desktop一起使用

将上面相同的JSON块添加到您的Claude Desktop配置文件中：

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

发展

git clone https://github.com/bbdaniels/kobo-mcp.git
cd kobo-mcp
pip install -e .

故障排除

“未设置KOBO_API_TOKEN”

服务器需要 KOBO_API_TOKEN 环境变量。确保它通过 env MCP配置块，或在运行前导出到shell中 claude mcp add.

要获取您的令牌：登录 Kobo工具箱 ->帐户设置->安全性->API密钥。

服务器未出现在Claude代码中

运行后 claude mcp add，重新启动Claude Code以使更改生效。您可以通过运行以下命令来验证服务器是否已注册：

claude mcp list

连接错误或超时

  • 请检查您的API令牌是否有效并且尚未被吊销。
  • 如果您在欧盟服务器上(eu.kobotoolbox.org)，确保您设置了 KOBO_SERVER 环境变量到 https://eu.kobotoolbox.org.
  • 默认服务器为 https://kf.kobotoolbox.org。如果您的组织使用自定义KoboToolbox实例，请设置 KOBO_SERVER 到其URL。

“uvx：找不到命令”

安装 uv 第一：

curl -LsSf https://astral.sh/uv/install.sh | sh

或者使用pip/pipx进行安装：

pip install uv

Python版本错误

Kobo MCP要求 Python 3.10或更高版本请使用以下工具检查您的版本：

python3 --version

许可证

麻省理工学院

相关 MCP