mcpField
W
worktrack-port

worktrack-port

本地服务
github.com/CloudCorpRecords生产力02 周前更新
代码仓库

关于 worktrack-port

worktrack-port 是通过 Atlassian REST API 操作 Jira 问题和 Confluence 页面的 MCP 服务，提供 12 项核心工具，覆盖搜索、读取、创建和更新；不包含原托管服务的 OAuth 接入。

主要功能

  1. 01搜索和管理 Jira 问题
  2. 02为 Jira 问题添加评论
  3. 03列出并读取 Jira 项目
  4. 04搜索和管理 Confluence 页面
  5. 05列出 Confluence 空间
  6. 06将纯文本转换为 ADF

适用场景

  1. 01使用 JQL 搜索 Jira 问题
  2. 02创建或更新问题并添加评论
  3. 03查找或编辑 Confluence 页面
  4. 04列出项目或空间

MCP 相关

它向 MCP 客户端提供 12 项 Jira 和 Confluence 操作工具，并使用账户邮箱、API 令牌和站点 URL 连接 Atlassian REST API。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-worktrack-port": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/worktrack-port"
      ]
    }
  }
}
启动命令npx -y @reneturcios/worktrack-port

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@reneturcios/worktrack-port0.1.0
ocighcr.io/cloudcorprecords/worktrack-port:0.1.0

工具

12

收录的工具列表 · 更新于 1 周前

参数类型必填说明
jqlstring是用于搜索 issue 的 JQL（Jira Query Language）查询。
max_resultsnumber否要返回的 issue 的最大数量。

详细介绍

worktrack-port

将 Jira 问题和 Confluence 页面作为 MCP 工具，通过 Atlassian REST API 进行交互。worktrack-port 是对 Atlassian 远程 MCP 服务核心功能的干净室重建，使用了新名称：工具名称和通信行为相同，代码全新，未复制品牌元素。原版是托管的远程 MCP 服务；此重建版本是兼容 REST 的客户端，可调用相同的上游 API——不包含托管 OAuth 功能。

工具（核心子集，12 个）

Jira：search_issues、get_issue、create_issue、update_issue、add_comment、list_projects、get_project。 Confluence：search_content、get_page、create_page、update_page、list_spaces。

此子集不包含：Jira 看板／冲刺／敏捷功能、工作流和转换管理、用户／群组管理、附件、仪表板和筛选器、服务台；Confluence 附件、标签、权限、子页面／祖先页面操作、博客文章，以及空间创建／删除。

纯文本问题描述和评论会在发送前转换为 Atlassian 文档格式（ADF）。

设置

为你的账户创建 Atlassian API 令牌，然后设置：

export [email protected]
export ATLASSIAN_API_TOKEN=...
export ATLASSIAN_SITE_URL=https://your-site.atlassian.net

缺少其中任何一项，所有工具调用都会失败，并指出缺少的变量（按 EMAIL、API_TOKEN、SITE_URL 的顺序检查）。

CLI

npx @reneturcios/worktrack-port search_issues '{"jql":"project = ABC"}'
npx @reneturcios/worktrack-port mcp        # stdio MCP server

每个工具名称都是一个子命令，接受一个 JSON 对象参数。

MCP 客户端配置

{
  "mcpServers": {
    "worktrack-port": {
      "command": "npx",
      "args": ["-y", "@reneturcios/worktrack-port", "mcp"],
      "env": {
        "ATLASSIAN_EMAIL": "[email protected]",
        "ATLASSIAN_API_TOKEN": "...",
        "ATLASSIAN_SITE_URL": "https://your-site.atlassian.net"
      }
    }
  }
}

Docker

docker run -i -e ATLASSIAN_EMAIL -e ATLASSIAN_API_TOKEN -e ATLASSIAN_SITE_URL ghcr.io/cloudcorprecords/worktrack-port

开发

npm install
npm run build
npm test

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。