MCP Server Runrunit

mcp服务器runrunit

MCP 服务器模型上下文协议与 API 集成 Runrun.it允许Claude直接通过MCP工具与Runrun.it的任务，用户和项目进行交互。

• API文件：https://runrun.it/api/documentation

可用工具

过滤器和工具参数

list_tasks

create_task — 强制性的： title, project_id

update_task — 必填项： id — 接受字段的任何组合 create_task + board_stage_id, is_closed

get_task_description — 必填项： task_id

update_task_description — 强制性的： task_id, body

list_projects

list_users

create_time_entry — 强制性的： task_id, amount, date

list_time_entries

先决条件

• Node.js 18+
• Runrun.it API 凭据： 应用密钥 e 用户令牌

- 访问 设置 → 集成 → API 在 Runrun.it 获取您的凭据

安装

git clone 
cd mcp-server-runrunit
npm install

创建文件 .env 雷兹：

RUNRUNIT_APP_KEY=sua_app_key
RUNRUNIT_USER_TOKEN=seu_user_token

与 Claude Code 一起使用

1. 将服务器添加到 settings.json

打开 Claude Code 设置 （/settings 你编辑 ~/.claude/settings.json）并添加：

{
  "mcpServers": {
    "runrunit": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:mariombn/mcp-server-runrunit"],
      "env": {
        "RUNRUNIT_APP_KEY": "${RUNRUNIT_APP_KEY}",
        "RUNRUNIT_USER_TOKEN": "${RUNRUNIT_USER_TOKEN}"
      }
    }
  }
}

替换 /caminho/absoluto/para/mcp-server-runrunit 在你的系统中真正的道路。

2.重新定义克劳德密码

保存设置后，重新启动 Claude Code 以加载 MCP 服务器。

3. 检查服务器是否处于活动状态

无克劳德代码，执行 /mcp 查看连接的服务器。服务器 runrunit 应该出现在可用工具列表中。

4. 在对话中使用工具

Claude 可以根据需要自动使用这些工具。您也可以直接要求它们：

Liste as tasks abertas do projeto X

Mostre os detalhes da task 1234

Quais tasks estão atribuídas a mim?

备选：使用已编译的构建

为了获得最佳的生产性能，请先编译：

npm run build

E配置o settings.json 使用 node 而不是 tsx:

{
  "mcpServers": {
    "runrunit": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:mariombn/mcp-server-runrunit"],
      "env": {
        "RUNRUNIT_APP_KEY": "${RUNRUNIT_APP_KEY}",
        "RUNRUNIT_USER_TOKEN": "${RUNRUNIT_USER_TOKEN}"
      }
    }
  }
}

开发

npm run dev          # roda direto com tsx (sem build)
npm run build        # compila para ./build
npm test             # roda os testes
npm run test:watch   # testes em modo watch
npm run test:coverage  # cobertura de código

项目结构

src/
├── index.ts          # Entry point: instancia o server, agrega tools, conecta transport
├── env.ts            # Validação de variáveis de ambiente (t3-env + zod)
├── client.ts         # runrunitFetch() + interfaces TypeScript da API
└── tools/
    ├── tasks.ts      # get_task(s), create/update_task, task_descriptions
    ├── users.ts      # get_me, list_users
    ├── projects.ts   # list_projects
    └── time.ts       # create_time_entry, list_time_entries

tests/
├── client.test.ts
└── tools/
    ├── tasks.test.ts
    ├── projects.test.ts
    ├── users.test.ts
    └── time.test.ts

堆栈

• TypeScript （严格模式，ESNext+NodeNext模块）
• @模型上下文协议/sdk MCP 官方 SDK
• t3 env+zod 环境变量的验证
• 获取本地 Node.js — 没有轴或 node-fetch
• Vitest 单位测试
• 多伦多证券交易所 para-dev， tsc 准建筑