QuickCall Integrations MCP 服务器

使用说明（Markdown 格式）

• 项目简介

  • 该仓库实现了一个基于 MCP 协议的服务器端，核心职责是向 LLM 客户端提供上下文信息与功能，包括资源托管、工具注册/执行，以及 Prompt 模板的定义与渲染。通过 JSON-RPC 风格的请求/响应与客户端交互，支持会话管理、能力声明及多传输通道。

• 主要功能点

  • 提供 Git、Slack、GitHub、认证等工具（Tools），供 LLM 客户端调用。
  • 提供 Slack、GitHub、Git 等资源（Resources），供上下文渲染与查询。
  • 支持身份认证流程（QuickCall 设备流，以及 GitHub PAT 替代方案）。
  • 定义 Utility、Git、Slack、GitHub 等类别的工具，涵盖时间、日期、仓库读取、消息发送等场景。
  • 通过 MCP 的 Server 实现，能够以 Stdio、WebSocket、SSE 等传输方式与客户端通信。
  • 引入自动化的测试用例，涵盖身份验证、集成工具调用与资源读取的流程。

• 安装步骤

  • 将代码克隆到本地后，进入仓库根目录执行：
    • 安装依赖（如需要）：根据项目使用的依赖管理工具安装依赖。
    • 启动服务器：直接运行 mcp_server/server.py，默认以标准输入输出模式启动。
  • 说明：服务器的启动命令在客户端需要进行配置，以便通过 MCP 客户端与服务器建立连接。

• 服务器配置（MCP 客户端所需信息，示例 JSON，含 server name、command、args 等）

  • server_name: quickcall-integrations
  • command: python
  • args: ["-m", "mcp_server.server"]
  • 额外说明: 运行环境可通过环境变量设置 QUICKCALL_API_URL 与 QUICKCALL_WEB_URL，以指向本地测试后端与前端服务。

  服务器配置示例（JSON，描述用途，不作为代码块展示）： { "server_name": "quickcall-integrations", "command": "python", "args": ["-m", "mcp_server.server"], "work_dir": "<仓库根目录路径>", "env": { "QUICKCALL_API_URL": "https://api.quickcall.dev", "QUICKCALL_WEB_URL": "https://quickcall.dev" } } 说明：

  • client 端通过以上配置能够启动对该服务器的连接，并通过 MCP 协议向服务器发送请求（如读取资源、调用工具、获取 Prompts 等）。
  • 服务器端实现了会话与能力声明机制，能够与具备正确授权的客户端协同工作。

• 基本使用方法

  • 启动后，客户端通过 MCP 协议连接并初始化会话。
  • 使用列表工具、读取资源、执行工具等接口来获取上下文信息、执行外部功能，形成可供 LLM 使用的上下文和能力。
  • 结合实际应用场景，借助资源、工具和提示模板来驱动更具上下文感知的对话流程。

• 运行与测试（可选）

  • 仓库提供了多项集成测试用例，覆盖 QuickCall 认证、GitHub/Slack 集成、资源读取等场景。
  • 测试通常通过 MCP 客户端连接到本地 MCP 服务器并执行工具调用进行验证。