AI导哈

Podio API代理服务

一个为AI代理提供Podio API访问的模型上下文协议服务器，旨在围绕用户目标而非原始API端点进行设计。

  • by stoskov
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 stoskov/podio-mcp

使用说明

跑道MCP服务器

一种MCP（模型上下文协议）服务器，允许AI代理访问Podio API。围绕用户想要实现的目标而设计，而不是围绕原始的API端点。

设置

1.安装依赖项

npm install

2.配置环境变量

复制 .env.example 并填写您的Podio API证书：

cp .env.example .env

您需要来自的Podio API密钥https://podio.com/settings/api.设置：

  • PODIO_CLIENT_ID -您的Podio API客户端ID
  • PODIO_CLIENT_SECRET -您的Podio API客户端机密
  • PODIO_USERNAME --您的podio帐户电子邮件
  • PODIO_PASSWORD --您的播客帐户密码

3.建造

npm run build

4.配置您的MCP客户端

将此添加到您的MCP客户端配置中（例如Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "podio": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-claude/dist/index.js"],
      "env": {
        "PODIO_CLIENT_ID": "your_client_id",
        "PODIO_CLIENT_SECRET": "your_client_secret",
        "PODIO_USERNAME": "your_email",
        "PODIO_PASSWORD": "your_password"
      }
    }
  }
}

工具（共10个）

工具 目的
search_podio 跨项目、应用程序和工作区搜索
get_workspace_overview 获取工作区的应用程序、成员和活动
list_items 列出和过滤应用程序中的项目（分页）
get_item_detail 获取包含字段、注释和任务的完整项目详细信息
create_item 使用简单的键值字段创建新项目
update_item 更新项目上的特定字段
add_comment 向项目添加评论
manage_task 创建、完成或更新任务
get_notifications 获取最近的通知
get_app_structure 获取应用程序的字段定义

设计原则

  • 目标导向工具：每个工具都映射到用户想要做的事情，而不是单个API端点。 get_workspace_overview 内部协调4个API调用。
  • 简单字段值: create_item 和 update_item 接受纯键值对象。服务器将它们映射到Podio的字段格式。
  • 人类可读的响应：所有响应都格式化为可读文本，从不使用原始JSON。较大的响应将被截断并显示警告。
  • 可操作的错误：字段名称错误？您将获得有效字段的列表。找不到应用程序？你会得到如何找到它的建议。
  • 始终分页: list_items 每页30个上限，采用基于偏移的分页。

典型工作流程

  1. search_podio 或 get_workspace_overview 找到合适的应用程序
  2. get_app_structure 学习田地
  3. list_items / get_item_detail 读取数据
  4. create_item / update_item / add_comment 写入数据

相关 MCP