Agent Framework MCP Server 集合

关键词

JSON-RPC模型上下文工具调用Jira 集成GitHub 集成

使用说明

  • 项目简介

    • 该仓库实现了基于 MCP 的服务器端组件，用于为 LLM 客户端提供标准化的资源访问、工具调用与提示模板渲染能力。通过多个 MCP 服务器（JIRA、GitHub、任务队列等）实现对外暴露的工具集合，支持通过标准的 JSON-RPC 调用获取工具、执行工具以及查询系统状态等能力。

  • 主要功能点

    • MCP 服务端实现：为 LLM 客户端提供标准化的 Tool 列表与调用入口，按 MCP 规范返回相应的 JSON-RPC 响应结构。
    • 工具注册与执行：实现多种工具集，如 queue_task_for_agent、get_queue_status、list_pending_tasks、get_task_details、get_epic_progress 等，LLM 可以调用这些工具完成任务编排、查询状态等操作。
    • 脚本化与多端集成：提供 Jira、GitHub 及任务队列相关的 MCP 服务器实现，支持同一 MCP 配置下多服务器协作。
    • 配置化与环境隔离：通过 config/mcp-config.json 指定各 MCP 服务器的启动命令、参数和环境变量，方便与现有的后端流程集成。
    • 运行时日志与监控：各 MCP 服务器实现包含基础日志输出，方便排错与观测。

  • 安装步骤

    • 构建 MCP 服务器
      • 进入 mcp-servers/jira，执行 npm install，然后 npm run build；同样为 mcp-servers/github、mcp-servers/task-queue 分别执行相同步骤。
    • 准备 MCP 配置
      • 在仓库根目录下创建或修改 config/mcp-config.json，按示例配置指定每个 MCP 服务器的命令与参数，以及环境变量映射。
    • 启动 MCP 服务器
      • 按照下方的服务器配置给出的指引启动各 MCP 服务，例如 Jira 与 GitHub 的 server 进程。
    • 配置客户端
      • MCP 客户端需要知道服务器的名字、启动命令及参数等信息，以便建立连接。配置信息采用 JSON 格式，包含 server name、command、args、env 等字段（示例见下方配置JSON片段，不作为代码展示给使用者）。

  • 服务器配置（MCP 服务器对接客户端所需信息，实际客户端不需要） { "mcpServers": { "jira": { "command": "node", "args": ["mcp-servers/jira/build/index.js"], "env": { "JIRA_SERVER": "${JIRA_SERVER}", "JIRA_EMAIL": "${JIRA_EMAIL}", "JIRA_API_TOKEN": "${JIRA_API_TOKEN}" } }, "github": { "command": "node", "args": ["mcp-servers/github/build/index.js"], "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" } }, "task-queue": { "command": "node", "args": ["mcp-servers/task-queue/build/index.js"], "env": {} } } } 注释说明

    • server: MCP 服务的名称标识，用于客户端连接与管理
    • command: 启动服务所使用的执行命令
    • args: 传给命令的参数列表，通常指向构建输出的入口文件
    • env: 运行时需要的环境变量映射（如 JIRA/GitHub 的访问凭证等）
    • 实际使用时，请根据本仓库实际路径和构建产物路径填写正确的 index.js 路径，以及所需环境变量

  • 基本使用方法

    • 构建并启动 MCP 服务组后，确保 JIRA、GitHub 环境变量正确设置。
    • MCP 客户端通过 JSON-RPC 调用时，将调用的工具名称（如 queue_task_for_agent、get_queue_status 等）和参数传入，服务器返回标准的 JSON-RPC 响应，或在错误时返回错误信息。
    • 坚持将 MCP 服务器与现有的 Jira/GitHub 工作流结合使用，以实现对话上下文的实时获取、外部功能调用及提示模板渲染。

  • 运行要点

    • MCP 服务器通常作为独立进程运行，建议采用系统服务或容器化部署，以便可靠地管理进程、日志和资源。
    • 需要在客户端侧确保对 MCP 服务器的可访问性（通过标准的传输协议，例如 Stdio、SSE、WebSocket 等实现）。
    • 日志与监控建议启用，便于对 MCP 服务的健康状态、工具调用成功率以及潜在错误进行追踪与排错。

  • 额外说明

    • 该仓库包含 Jira、GitHub、任务队列等多组 MCP 服务器实现，具备完整的后端能力，并且具备可运行的实现路径（需完成构建）。它不仅包含服务器实现，还包含对 MCP 配置、日志、监控与安全性设计的全面实现。

服务器信息

访问项目