关键词

Jira集成Figma集成AI代理工具OAuth认证项目管理自动化

项目简介

Jira Figma MCP 工具桥（Cascading MCP Tools）是一个基于Model Context Protocol (MCP) 构建的后端服务，旨在将Atlassian Jira和Figma的设计与项目管理功能，通过OAuth认证的方式，暴露给大型语言模型（LLM）客户端（如VS Code Copilot）。它允许AI代理执行如获取Jira任务、访问Figma设计、从设计生成用户故事并写入Jira等复杂操作，极大地增强了LLM在设计和项目管理领域的自动化能力。

主要功能点

  • Jira 集成: 通过OAuth认证，安全地获取Jira工作项、附件和图像。
  • Figma 集成: 访问Figma设计文件，下载图像，并分析屏幕布局。
  • 组合工具: 结合Jira和Figma功能，例如，从Figma设计中生成用户故事并直接写入Jira史诗。
  • 多方OAuth认证: 支持Atlassian和Figma的无缝OAuth认证流程。
  • 会话管理: 提供基于会话的MCP服务器实例，根据用户权限动态注册工具。
  • AI 代理集成: 允许LLM客户端通过JSON-RPC协议调用其托管的各种工具，实现智能自动化。

安装步骤

本仓库是一个已部署的服务，通常无需本地安装即可使用。但如果您需要部署自己的实例，以下是通用指导：

  1. 环境准备: 确保您的系统安装了Node.js (版本18或更高) 和npm或yarn。
  2. 克隆仓库: 使用Git将此仓库克隆到本地。
  3. 安装依赖: 在项目根目录运行 'npm install' 或 'yarn install'。
  4. 配置环境变量: 创建 '.env' 文件，并根据 'server/server.ts' 和 'pkce/discovery.ts' 等文件中的 'process.env' 变量配置 OAuth 客户端ID/密钥、会话密钥等关键信息。
  5. 启动服务器: 运行 'npm start' 或 'yarn start' 启动MCP服务器。

服务器配置

MCP服务器通常部署为HTTP服务。您的MCP客户端（如VS Code Copilot）需要配置此服务器的URL才能与其建立连接。 对于VS Code Copilot，您可以在项目根目录的 '.vscode/mcp.json' 文件中添加以下配置：

{
    "servers": {
        "bitovi-jira-mcp": {
            "url": "https://jira-mcp-auth-bridge.bitovi.com/mcp"
        }
    }
}
  • 'bitovi-jira-mcp': 这是您为MCP服务器实例指定的名称，可以自定义。
  • 'url': 这是MCP服务器的HTTP端点URL。请注意，此配置适用于HTTP连接，不同于命令行（'command'）或参数（'args'）启动的本地服务器。

配置完成后，您的MCP客户端将能够通过此URL发现并连接到MCP服务器，从而使用其提供的工具。

基本使用方法

  1. 连接MCP客户端: 根据上述“服务器配置”步骤连接您的MCP客户端（例如VS Code Copilot）。
  2. 进行OAuth认证: 客户端连接后，服务器将引导您完成Atlassian和/或Figma的OAuth认证流程。
  3. 查询可用工具: 认证成功后，您可以在LLM客户端中向AI代理提问，例如：“MCP: 我有哪些可用工具？”（'MCP: what tools do I have available?'），服务器将返回可用的Jira和Figma相关工具列表。
  4. 调用工具: 根据可用的工具列表，LLM客户端可以根据您的指令调用特定工具，例如：
    • 获取Jira问题详情。
    • 下载Figma设计图像。
    • 结合Figma设计和Jira史诗生成用户故事。

信息

分类

开发者工具

访问项目