CoWork OS MCP 服务器集合

关键词

多提供者接入外部API整合工具暴露进程间通信安全上下文
  • 说明摘要
    • 这是一个面向 MCP 的服务器实现集合，核心功能包括：暴露资源供 LLM 访问、注册并执行工具（Tools）、定义并渲染提示模板（Prompts），并通过 JSON-RPC 与客户端通信。服务器支持初始化握手、获取工具列表、执行工具调用及优雅的关闭等操作。
    • 实现方式以 STDIO 形式为主，读取标准输入中的 MCP 请求并输出相应的 JSON-RPC 响应到标准输出，便于与多种客户端（包括本地模拟、管道传输等）对接。
  • 主要特性（简述）
    • MCP 基本协议支持：初始化、工具列表、工具调用、关闭等请求/通知的处理。
    • 多工具暴露：每个服务器实现提供若干工具（Tools），并对输入进行校验和封装，返回结构化响应。
    • 服务器端实现完整：包含服务器端的请求解析、能力声明、错误处理、结果封装等。
    • STDIO 传输：通过标准输入/输出进行 MCP 的通讯，便于在脚本化环境中集成。
    • 针对具体服务的工具实现：如 Linear、HubSpot、Jira、Salesforce、Zendesk、Asana 等，均通过各自的客户端封装（Health、List/Search/Get/Update 等）实现对外暴露的工具。
  • 安装与运行要点
    • 该仓库中的 MCP 服务器实现通常需要将 TypeScript 代码编译为可执行的 JavaScript，然后通过 Node.js 运行。每个连接器的入口在 connectors/<name>-mcp/src/index.ts，通常需先执行依赖安装与构建步骤，在 dist 路径下产出可执行文件后启动。
    • 运行命令示例（需按实际编译产物路径调整）：
      • node dist/connectors/linear-mcp/index.js
    • 运行前的环境变量与依赖，请参考各连接器的 README 配置（如 LINEAR_API_KEY、LINEAR_BASE_URL 等），部分连接器需提供认证凭证以调用外部服务。
  • 服务器配置（MCP 客户端使用信息）
    • 说明：MCP 客户端需要一个 JSON 配置来描述要连接的 MCP 服务器，包括服务器名称、要执行的启动命令及参数等。以下为示例结构，实际使用请替换为对应服务器的真实可执行路径与参数。
    • 示例配置（JSON，供 MCP 客户端使用，用于登记并启动服务器）： { "serverName": "Linear Connector", "command": "node", "args": ["dist/connectors/linear-mcp/index.js"], "env": { "LINEAR_BASE_URL": "https://api.linear.app/graphql", "LINEAR_API_KEY": "<your-linear-api-key>" }, "description": "暴露 Linear 的 MCP 服务，提供健康检查、项目/问题等工具调用" } 说明：
    • serverName：服务器对外暴露的名称，应与 serverInfo 中的服务器名称保持一致，便于注册和标识。
    • command / args：启动服务器的命令及参数，通常指向编译后的入口脚本路径。
    • env：运行时所需的环境变量，例如 API 访问地址与密钥等，请按具体连接器的需要设定。
    • description：对该 MCP 服务器的简要描述，便于在注册目录中区分。
  • 基本使用方法
      1. 构建与启动
      • 安装依赖、编译 TS 代码为 JS，确保 dist/... 目录下有可执行入口。
      • 使用 Node.js 启动入口，例如 node dist/connectors/linear-mcp/index.js。
      1. 与 MCP 客户端对接
      • MCP 客户端通过 JSON-RPC 与服务器通信，先发起 initialize 请求以获取协议版本、服务器能力等信息，随后可以请求获取工具列表（tools/list）并调用工具（tools/call）。
      • 服务器在接收到 destroy/shutdown 请求后会进行清理并退出。
      1. 使用提示
      • 客户端在使用工具时需要传入 tool 名称和参数，例如 ["linear.health"]、["linear.list_projects", { limit: 10 }]、["linear.get_issue", { id: "ABC-123" }] 等，服务器将返回标准的 JSON-RPC 风格响应或错误信息。
      1. 安全与凭证
      • 不同连接器对外部服务的访问需要对应的 API 密钥或凭证，请确保在启动前已配置好所需的凭证，并通过环境变量注入给服务器进程。
      1. 运行环境与依赖
      • 该集合中的服务器多为 Node/TypeScript 实现，运行前需安装 Node.js 和构建工具，确保 TS 编译输出可被 Node 直接执行。
  • 设计与扩展性要点
    • 统一的 Stdio MCP 服务器框架：提供了工具清单和执行能力的通用实现，便于增加新连接器。
    • 针对企业服务的工具实现：每个连接器通过专门的客户端封装对外部 API 提供统一工具入口，降低了对接复杂度。
    • 如需自定义新的 MCP 服务，只需实现 ToolProvider（getTools、executeTool）并创建 MCP 服务信息即可在现有框架之上扩展。

服务器信息

访问项目