Planio MCP

planio mcp

MCP服务器 红矿 / 计划.通过标准Redmine REST API对问题、时间条目、项目和用户进行完全读/写访问。

兼容 任何Redmine实例.Planio特定功能（清单）可通过功能标志选择加入。

设计理念

此服务器是 意图界面，而不是API代理。代理人说 *它想要什么* --服务器知道了 *怎么*.

• 名称解析 — tracker_id: "Bug", priority_id: "High", activity_id: "Development" 服务器在内部将名称解析为ID。如果不匹配，它将返回有效选项，以便代理自行纠正。
• 项目标识符 — project_id 接受两个数字ID(5)以及Redmine标识符("my-project")所有工具。
• 情境反馈 --预订时间返回问题的时间预算。逾期问题显示警告。代理人不需要后续电话来了解情况。
• 当前用户默认值 — list_time_entries 和 get_activity 默认为经过身份验证的用户，就像任何登录的UI一样。通过 user_id 只有当你需要别人的数据时。
• 自动分页 — list_time_entries 自动获取所有匹配的条目（最多500个）。无需手动偏移/限制。
• 向后兼容 --数字ID仍然适用于所有地方。客户端发送 {"tracker_id": 3} 如int或 "3" 因为字符串都被处理了。

设置

1.建造

xcodebuild -scheme planio-mcp -configuration Release build

或者在Xcode中打开 Cmd+B.

2.配置

# Required
TICKET_URL=https://your-instance.plan.io
TICKET_KEY=your-api-key-here

# Feature flags (opt-in, default: false)
FEATURE_CHECKLISTS=true

地点为 .env 在二进制文件旁边，在工作目录中，或通过环境变量传递。 您还可以指定自定义路径： planio-mcp --env /path/to/.env

配置优先级： ENV vars > .env file

API密钥： Redmine/Planio→ 你的头像→ 我的账户→ 侧边栏→ 显示API密钥

3.连接

克劳德桌面/克劳德代码

添加到MCP配置(claude_desktop_config.json 或 .claude/settings.json):

{
  "mcpServers": {
    "redmine": {
      "command": "/absolute/path/to/planio-mcp",
      "env": {
        "TICKET_URL": "https://your-instance.plan.io",
        "TICKET_KEY": "your-api-key-here",
        "FEATURE_CHECKLISTS": "true"
      }
    }
  }
}

MCP检验员（测试）

npx @modelcontextprotocol/inspector /absolute/path/to/planio-mcp

工具

问题

时间条目

项目和用户

活动

名称解析

所有可解析字段都接受 名字 （字符串）或a 数字ID服务器通过缓存的元数据解析名称。

如果不匹配，错误消息将列出所有有效选项：

No tracker named 'Defect'. Available: Bug, Feature, Support, Task

情境反馈

服务器用可操作的上下文丰富了响应，因此代理不需要后续调用：

• 预订时的时间预算 --之后 create_time_entry，响应包括 Issue #4523 time: 23.0h of 30.0h
• 活动日志中的时间预算 — get_activity 显示 #4523: Fix auth flow (23.0h of 30.0h) 每张票
• 到期日警告 — get_issue 和 list_issues 显示未关闭问题的警告：

- ⚠ OVERDUE by 5 days (due 2026-03-06) - ⚠ Due today (2026-03-11) - ⚠ Due in 2 days (2026-03-13)

功能开关

当特征标志关闭时，相应的参数为 从工具架构中删除 --法学硕士从未见过他们。

提示示例

What did I work on last week?

Book 2h on #1234, activity Development, comment "API refactoring"

Create a bug "Login broken on Safari" in project my-project, priority High, assign to John

Show me all open issues assigned to me, sorted by priority

Update #1234 status to "In Progress" and assign to me

List all Feature issues in Sprint 12

建筑

planio-mcp/
├── main.swift                 # Server setup, tool routing
├── Config.swift               # .env parsing, feature flags
├── PlanioClient.swift         # HTTP client (actor, cached metadata + issues)
├── Models/
│   ├── Issue.swift            # Issue, Journal, Checklist, Relations, shared types
│   ├── IssueFilterOptions.swift # Section filtering for get_issue output
│   ├── MetadataResponses.swift  # Statuses, Priorities, Trackers response models
│   ├── TimeEntry.swift
│   ├── Project.swift
│   └── User.swift
├── Tools/
│   ├── ToolDefinitions.swift  # JSON Schema definitions (feature-aware)
│   ├── IssueTools.swift       # CRUD + watchers + name resolution
│   ├── TimeEntryTools.swift   # CRUD + activity resolution + time budget
│   ├── ProjectTools.swift
│   ├── UserTools.swift
│   └── ActivityTools.swift    # Composite activity log with time budget per ticket
└── Helpers/
    ├── NameResolver.swift     # Name-to-ID resolution with guided errors
    ├── ValueHelpers.swift     # MCP Value extraction, type-flexible param reading
    └── ResponseFormatter.swift # Output formatting, due date warnings

备注

• Redmine兼容 -所有端点都是标准的Redmine REST API
• 认证： X-Redmine-API-Key 头球
• 缓存： 问题和元数据（状态、优先级、跟踪器、每个项目的元数据）的5分钟内存TTL。写入时自动失效。当前用户在进程生命周期内被缓存（不可变）。批量提取(get_activity, bulk_get_issues)跳过已经缓存的问题——TTL内的重复调用几乎是即时的。
• 并行取数： get_activity 和 bulk_get_issues 使用支持缓存的批量加载（10个并发）和进度通知。
• Swift 5/macOS --用途 mcp swift sdk