Atlassian MCP Server Client

Atlassian MCP 服务客户端

用于连接 Model Context Protocol（MCP）服务的命令行客户端，专为配合 Atlassian 官方 MCP 服务集成而设计。该客户端提供由 OpenAI 驱动的交互式聊天界面，可与远程 MCP 服务无缝交互。

🚀 功能

• 远程 MCP 服务连接：通过 mcp-remote 连接到任意 MCP 服务
• 交互式聊天界面：集成 OpenAI 的命令行聊天界面
• OAuth 支持：通过 mcp-remote 自动处理 Atlassian 服务的 OAuth 认证
• 工具发现：自动发现并使用 MCP 服务提供的工具
• 流式响应：实时流式输出 AI 响应
• 跨平台：支持 Windows、macOS 和 Linux

📋 前提条件

• Node.js 18.0.0 或更高版本
• npm 包管理器
• OpenAI API 密钥

🛠️ 安装

1. 克隆仓库：

   git clone <repository-url>
   cd jira-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 设置环境变量：

   cp env.example .env
   

4. 配置 OpenAI API 密钥： 编辑 .env 文件：

   # OpenAI Configuration
   OPENAI_API_KEY=your_openai_api_key
   

🔐 获取 OpenAI API 密钥

1. 访问 OpenAI API 密钥
2. 创建新的 API 密钥
3. 将其复制到 .env 文件中

🚀 使用方法

连接到 Atlassian 官方 MCP 服务

npm run dev

默认情况下，这会连接到 https://mcp.atlassian.com/v1/sse。

连接到自定义 MCP 服务

npm run dev <server-url>

示例：

npm run dev wss://your-custom-mcp-server.com

开发命令

• npm run build - 将 TypeScript 编译为 JavaScript
• npm run dev [server-url] - 在开发模式下运行（默认连接 Atlassian MCP 服务）
• npm run clean - 移除构建产物
• npm run typecheck - 运行 TypeScript 类型检查

💬 交互式聊天

连接成功后，你会看到一个交互式提示界面，可以：

• 询问有关 Atlassian 工作区的问题（连接到 Atlassian MCP 服务时）
• 使用自然语言与 MCP 服务提供的任意工具交互
• 利用已连接服务的功能获取 AI 驱动的响应

会话示例

🔗 Connecting to remote MCP server: https://mcp.atlassian.com/v1/sse
🔐 OAuth authentication will be handled automatically by mcp-remote
🌐 A browser window may open for authentication
🤝 Connecting to MCP server...
🛠️ Setting up tools...
✅ Connected successfully with tools: [list-jira-issues, search-confluence, ...]

💬 Chat with AI (type 'help' for commands, 'exit' to quit):
> What are my recent Jira issues?

🤖 Processing query...
Here are your recent Jira issues...

特殊命令

• help - 显示可用命令和用法信息
• list-tools - 显示已连接 MCP 服务提供的所有工具
• exit 或 quit - 退出应用程序

🔧 配置

环境变量

变量	说明	必需
OPENAI_API_KEY	你的 OpenAI API 密钥	✅

OAuth 认证

连接到 Atlassian 的 MCP 服务时，mcp-remote 会自动处理 OAuth 认证。如有需要，系统会打开浏览器窗口，让你使用 Atlassian 账户进行认证。

🏗️ 架构

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   CLI Client    │◄──►│   mcp-remote    │◄──►│   MCP Server    │
│   (this app)    │    │                 │    │   (Atlassian)   │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   OpenAI API    │    │ OAuth Handler   │    │ Atlassian APIs  │
│                 │    │                 │    │                 │
└─────────────────┘    └─────────────────┘    └─────────────────┘

🛠️ 工作原理

1. 连接：客户端使用 mcp-remote 与指定的 MCP 服务建立连接
2. 认证：mcp-remote 会自动处理 OAuth 流程
3. 工具发现：从 MCP 服务发现可用工具
4. 聊天界面：使用 OpenAI 和已发现的工具处理用户查询
5. 工具执行：根据需要调用远程 MCP 服务上的工具

🐛 故障排除

常见问题

1. “OPENAI_API_KEY is not set”

   • 确认 .env 文件中包含有效的 OpenAI API 密钥

2. “mcp-remote installation failed”

   • 应用程序会尝试自动全局安装 mcp-remote
   • 如果失败，请手动安装：npm install -g mcp-remote

3. OAuth 认证失败

   • 确认你有权访问 Atlassian 工作区
   • 检查浏览器是否允许来自认证域的弹出窗口
   • 确认网络连接正常

4. 连接超时

   • 检查 MCP 服务 URL 是否正确且可访问
   • 确认防火墙设置允许出站连接

调试模式

如需查看详细日志，可检查 mcp-remote 日志，或修改源代码以添加更多日志记录。

🔗 依赖

• @ai-sdk/openai：用于 AI 功能的 OpenAI 集成
• @modelcontextprotocol/sdk：用于客户端实现的官方 MCP SDK
• mcp-remote：远程 MCP 服务连接工具（自动安装）
• ai：用于工具集成和流式传输的 AI SDK

📚 了解更多

• Model Context Protocol - MCP 官方文档
• Atlassian MCP Server - Atlassian 官方 MCP 服务
• OpenAI API Documentation - OpenAI API 参考

---

注意：这是一个用于连接 MCP 服务的客户端应用。有关实际 MCP 服务实现，请参阅 Atlassian 官方 MCP 服务文档。