使用说明

项目简介该仓库提供一组基于 MCP（Model Context Protocol）的服务器实现，每个服务器都具备资源管理、工具注册与对外暴露的 PROMPT/模板能力，支持多种传输方式（如 STDIO、REST Gateway 等），可直接对接 LLM 客户端进行上下文信息提供和外部功能调用。
主要功能点
- 资源管理：集中托管和访问资源数据，供 LLM 客户端查询。
- Tools/工具注册与执行：为外部服务提供可调用的工具集合，LLM 通过 MCP 调用工具并获取结果。
- Prompt/模板渲染：提供可配置的提示模板渲染，用于灵活地与模型交互。
- 多传输协议：内置 STDIO 传输，部分实现支持 REST 网关等传输方式，确保与 Claude Desktop、Peta Core 等的对接。
- 会话与安全：内置令牌/认证方案、日志脱敏、错误转换等机制，确保安全可观测的操作。
安装步骤
- 针对单个服务器（示例）：
  1. 进入对应服务器目录，例如 mcp-google-calendar
  2. 安装依赖：npm install
  3. 构建/编译：npm run build
  4. 以 STDIO 方式运行入口：npm run start 或 node dist/stdio.js（具体入口脚本以对应服务器的 README 为准）
- 整体运行：每个 MCP 服务器都是独立的服务单元，可按需启动单元，逐步对接到同一 LLM 客户端。
服务器配置（MCP 客户端用途） MCP 客户端需要一个 JSON 配置来启动和连接 MCP 服务器。以下示例展示了一个通用配置结构，描述了服务器名称、启动命令与参数。请将具体的 token、路径等替换为实际值。此配置示例仅供参考，实际使用时请为每个服务器单独配置。

{ "mcpServers": { "google-calendar": { "command": "docker", "args": [ "run", "--pull=always", "-i", "--rm", "-e", "ACCESS_TOKEN", "ghcr.io/dunialabs/mcp-servers/google-calendar:latest" ], "comment": "Google Calendar MCP 服务器（STDIO/Claude 桌面集成所需的 accessToken）" }, "mcp-github": { "command": "docker", "args": [ "run", "--pull=always", "-i", "--rm", "-e", "accessToken", "ghcr.io/dunialabs/mcp-servers/github:latest" ], "comment": "GitHub MCP 服务器（需要 accessToken 的 GitHub API 访问）" }, "mcp-notion": { "command": "docker", "args": [ "run", "--pull=always", "-i", "--rm", "-e", "notionToken", "ghcr.io/dunialabs/mcp-servers/notion:latest" ], "comment": "Notion MCP 服务器（需要 notionToken 认证）" }, "mcp-figma": { "command": "docker", "args": [ "run", "--pull=always", "-i", "--rm", "-e", "accessToken", "ghcr.io/dunialabs/mcp-servers/figma:latest" ], "comment": "Figma MCP 服务器（需要 accessToken）" }, "mcp-rest-gateway": { "command": "docker", "args": [ "run", "--pull=always", "-i", "--rm", "-e", "GATEWAY_CONFIG", "ghcr.io/dunialabs/mcp-servers/rest-gateway:latest" ], "comment": "REST Gateway 将 REST API 转换为 MCP 工具集（通过 GATEWAY_CONFIG 配置）" } } }

基本使用方法
- 选择需要的 MCP 服务器，在环境中设置所需的凭证信息（如 accessToken、notionToken、zendeskSubdomain 等）。
- 通过提供的入口脚本启动服务（STDIO 模式），确保 Claude Desktop 或 Peta Core 能正确连接。
- 参考各服务器的 README 文档了解具体工具、参数与返回内容格式，结合 MCP JSON-RPC 调用进行交互。
注意事项
- 不同服务器可能需要不同的认证方式，请在启动前准备好相应的 API token/认证信息，并在环境变量中暴露。
- 日志默认脱敏处理，敏感信息不会在日志中明文暴露。
- 如需在 Docker/云端部署，请参照 README 的 Docker 镜像信息和运行参数进行部署。
可能的扩展
- 为更多服务快速接入新的 MCP 服务器实例。
- 将多服务器集中管理的配置模板化，简化同一群组内服务的统一部署。

关键词

信息