工作集成 MCP

这是一个小型 MCP 服务器，为多个工作系统提供工具（目前支持 Jira，计划支持 Slack/GitHub 等）。

当前工具

• jira_get_issue - 通过键获取 Jira 问题

• jira_search - 使用 JQL 搜索 Jira

• slack_get_message_by_url - 通过 URL 获取 Slack 消息

• slack_get_channel_history - 获取最近的 Slack 消息

• slack_find_channel - 将频道名称解析为 ID

• slack_find_user - 通过电子邮件或显示名称解析用户

• confluence_get_page - 通过 ID 获取 Confluence 页面（包含页脚 + 带有嵌套回复的内联评论）

• confluence_get_page_by_url - 通过 URL 获取 Confluence 页面（包含页脚 + 带有嵌套回复的内联评论）

• confluence_search - 使用 CQL 搜索 Confluence

设置

1. 安装依赖：

   • npm install

2. 配置环境变量（示例）：

   • JIRA_BASE=https://company.atlassian.net

   • JIRA_EMAIL=you@company.com

   • JIRA_TOKEN=your_api_token

   • JIRA_API_VERSION=3

   • SLACK_TOKEN=xoxb-your-slack-bot-token

   • CONFLUENCE_BASE=https://company.atlassian.net/wiki

   • CONFLUENCE_EMAIL=you@company.com

   • CONFLUENCE_TOKEN=your_api_token

3. 在 Cursor 中注册 MCP 服务器 (~/.cursor/mcp.json)：

   {
     "mcpServers": {
       "work-integrations-mcp": {
         "command": "npx",
         "args": [
           "tsx",
           "/ABS/PATH/jira-mcp/server.ts"
         ],
         "env": {
           "JIRA_BASE": "https://company.atlassian.net",
           "JIRA_EMAIL": "you@company.com",
           "JIRA_TOKEN": "your_api_token",
           "JIRA_API_VERSION": "3",
          "SLACK_TOKEN": "xoxb-your-slack-bot-token",
          "CONFLUENCE_BASE": "https://company.atlassian.net/wiki",
          "CONFLUENCE_EMAIL": "you@company.com",
          "CONFLUENCE_TOKEN": "your_api_token"
         }
       }
     }
   }

4. 重启 Cursor。

使用示例

• “使用 jira_get_issue，键为 CVR-248”

• “使用 JQL 搜索 Jira：project = CVR ORDER BY updated DESC”

• “使用 slack_get_message_by_url，URL 为 https://...”

• “使用 slack_get_channel_history，频道为 general”

• “使用 slack_find_user，电子邮件为 user@company.com”

• “使用 confluence_get_page，ID 为 123456”

• “使用 confluence_get_page_by_url，URL 为 https://.../wiki/...”

• “使用 confluence_search，CQL 为 space = DOCS and type = page”

Slack 设置说明

创建一个 Slack 应用并将其安装到您的工作区中。公共频道的最低权限范围：

• channels:read

• channels:history

• users:read

• users:read.email

对于私有频道，请添加：

• groups:read

• groups:history

扩展

通过在 services/ 下添加新文件夹并在 server.ts 中注册模块，可以为 Slack、GitHub 或其他服务添加新工具：

1. 创建 services/<service>/client.ts 用于身份验证和 API 调用

2. 创建 services/<service>/tools.ts 并导出 ToolModule

3. 在 server.ts 中导入该模块并将其传递给 mergeToolModules

4. 如果需要，在 Cursor MCP 配置中添加任何新的环境变量

请保持工具名称稳定，以便现有的提示词能够继续正常工作。