### 使用 Python 的 `fastmcp` 库与 Jira MCP Server 进行集成 要通过 Python 的 `fastmcp` 接口集成到 Jira MCP Server，需要遵循标准的 MCP 协议实现方式，并结合 Jira 提供的数据接口完成集成。以下是一个详细的实现流程： #### 环境准备 在开始之前，确保系统中已安装 Python 3.8 或更高版本，并且具备访问 Jira 实例的权限。此外，还需要安装 `fastmcp` 库以及相关的依赖项。 ```bash pip install fastmcp uvx ``` #### 初始化 MCP 服务器模块 创建一个 Python 文件（例如 `jira_mcp_server.py`），并导入必要的模块。定义一个符合 MCP 协议的服务端点，用于处理来自客户端的请求。 ```python from fastmcp import mcp, server # 定义 Jira 相关配置参数 JIRA_URL = "https://your-jira-instance.atlassian.net" JIRA_TOKEN = "your-personal-access-token" JIRA_USER = "your-username" # 初始化 MCP 服务实例 app = server.Server( name="jira-mcp", description="MCP server for integrating with Jira", capabilities=[ "read-issues", "create-issue", "update-issue" ] ) ``` #### 实现 Jira 数据交互逻辑 接下来，实现具体的 Jira 操作函数，如读取 Issue、创建 Issue 和更新 Issue。这些函数将被 MCP 服务调用以响应客户端请求。 ```python import requests def get_issue(issue_key): url = f"{JIRA_URL}/rest/api/3/issue/{issue_key}" auth = (JIRA_USER, JIRA_TOKEN) response = requests.get(url, auth=auth) return response.json() def create_issue(project_key, summary, description): url = f"{JIRA_URL}/rest/api/3/issue" auth = (JIRA_USER, JIRA_TOKEN) payload = { "fields": { "project": {"key": project_key}, "summary": summary, "description": {"content": [{"type": "paragraph", "text": description}]}, "issuetype": {"name": "Bug"} } } response = requests.post(url, json=payload, auth=auth) return response.json() @app.register("read-issues") def handle_read_issues(params): issue_key = params.get("issueKey") return get_issue(issue_key) @app.register("create-issue") def handle_create_issue(params): project_key = params.get("projectKey") summary = params.get("summary") description = params.get("description") return create_issue(project_key, summary, description) ``` #### 启动 MCP 服务器 最后，在文件末尾添加启动代码，使得可以直接运行该脚本启动 MCP 服务器。这一步可以使用 `fastmcp.run_single_stdio()` 方法来在标准输入输出模式下运行服务器。 ```python if __name__ == "__main__": print("Starting Jira MCP server in stdio mode...") app.run_single_stdio() ``` #### 配置 MCP 客户端连接 在支持 MCP 的客户端工具（如 Cursor）中配置连接信息，指向本地运行的 MCP 服务器。通常需要编辑 `.cursor/mcp.json` 文件，并指定对应的命令和参数。 ```json { "jira-mcp": { "command": "python", "args": ["jira_mcp_server.py"] } } ``` 完成上述步骤后，即可通过支持 MCP 的开发工具访问 Jira 数据，并执行相关操作。 ---