Universal MCP Toolkit

通用mcp工具包

 ](https://www.npmjs.com/package/universal-mcp-toolkit) 

用于生产就绪的模型上下文协议服务器的规范开源monorepo。

如果你曾经想在一个地方找到适用于GitHub、Slack、Notion、数据库、云平台、研究资源和本地文件的优秀MCP服务器，而不需要将十几个未完成的存储库拼接在一起，那么这就是它。

⚡ 快速开始

最快的出行方式：

# See all 28 available servers
npx universal-mcp-toolkit list

# Interactive setup — pick your servers, choose transport, write config
npx universal-mcp-toolkit install

# Generate a Claude Desktop config snippet
npx universal-mcp-toolkit config --server github slack filesystem --target claude-desktop

# Run a server locally
npx universal-mcp-toolkit run github --transport stdio

# Check your environment before debugging
npx universal-mcp-toolkit doctor github

有关安装指南演练，请打开 docs/getting-started.html.

或全局安装：

npm install -g universal-mcp-toolkit
umt list

为什么存在

MCP生态系统正在爆炸式增长，但开发人员的体验仍然支离破碎。

• 大多数repo解决了一个狭窄的集成问题。
• 许多服务器只停留在一两个演示质量工具上。
• 传输支持、身份验证处理、文档和打包非常不一致。
• 没有明显的参考实现来显示一个严肃的MCP单回购应该有什么感觉。

universal-mcp-toolkit 用一个固执己见、高质量的Turborepo修复了这个问题：

• 27台专注于生产的MCP服务器
• 一个共享的严格模式TypeScript核心
• 一个经过优化的CLI，用于安装、配置、运行和诊断
• 一致的Zod验证、结构化错误和pino日志记录
• 整个工具包支持Stdio加HTTP+SSE
• 发现友好 .well-known/mcp-server.json 服务器卡

是什么让这部电影值得主演

• 现在真正的开发人员实用程序
• Claude Desktop、Cursor和本地工作流程的默认人体工程学
• 一个你可以学习一次并扩展到任何地方的单一架构
• 强大的包卫生功能，包括导出映射、关键字、构建脚本和测试挂钩
• 设计为既是产品又是参考实现的仓库

简短版本

实验配套套餐 @contextcore/* 目前的范围包括用于单独发布线和测试通道的Notion、Slack、Playwright和OpenAI变体。

比较

支持的服务器

一些服务器还公开了可选的调优变量，例如 POSTGRESQL_ALLOW_WRITES, REDIS_ALLOW_WRITES, MONGODB_ALLOW_WRITE_PIPELINES, VERCEL_TEAM_ID，或 FILESYSTEM_MAX_READ_BYTES.根 .env.example 包括最有用的旋钮。

存储库布局

universal-mcp-toolkit/
├─ packages/
│  ├─ core/
│  └─ cli/
├─ docs/
│  ├─ index.html
│  └─ getting-started.html
├─ servers/
│  ├─ github/
│  ├─ notion/
│  ├─ slack/
│  ├─ linear/
│  ├─ jira/
│  ├─ google-calendar/
│  ├─ google-drive/
│  ├─ spotify/
│  ├─ stripe/
│  ├─ postgresql/
│  ├─ mongodb/
│  ├─ redis/
│  ├─ supabase/
│  ├─ vercel/
│  ├─ cloudflare-workers/
│  ├─ docker/
│  ├─ npm-registry/
│  ├─ hackernews/
│  ├─ arxiv/
│  ├─ discord/
│  ├─ airtable/
│  ├─ trello/
│  └─ filesystem/
├─ turbo.json
├─ pnpm-workspace.yaml
└─ README.md

快速启动

克隆并安装

git clone https://github.com/Markgatcha/universal-mcp-toolkit.git
cd universal-mcp-toolkit
corepack pnpm install

构建工作空间

corepack pnpm build

探索可用的内容

corepack pnpm --filter universal-mcp-toolkit exec umt list

生成主机配置代码段

corepack pnpm --filter universal-mcp-toolkit exec umt config --server github slack filesystem --target claude-desktop --mode workspace

在本地运行服务器

corepack pnpm --filter universal-mcp-toolkit exec umt run github --transport stdio

检查您的环境

corepack pnpm --filter universal-mcp-toolkit exec umt doctor github

CLI体验

CLI的设计感觉就像一个真正的产品，而不是一堆脚本。

umt list

查看每个可用的服务器，按类别分组，并包含所需的环境变量和描述。

umt config

为Claude Desktop、Cursor或任何兼容MCP的主机配置流生成可粘贴的JSON。

umt install

运行交互式设置流程，选择服务器，选择 npx 在工作区模式下，将结果写入磁盘，并保存配置文件以供以后参考。

umt run

使用stdio或HTTP+SSE传输在本地启动任何构建的工作区服务器。

这 --supervise 标志启用碰撞循环检测和自动重启：

umt run github --transport stdio --supervise

如果服务器在60秒内崩溃5次，它将停止重试。日志被写入下的状态目录 logs/.log 并且可以用 umt logs .

umt doctor

在浪费时间调试丢失的令牌之前，请检查构建输出、配置状态和所需的环境变量 dist 文件。

v1.1.0中的新功能+

配置示例

克劳德桌面版

将生成的代码片段粘贴到Claude Desktop配置文件中。在Windows上，通常是：

%APPDATA%\Claude\claude_desktop_config.json

在macOS上，使用 ~/Library/Application Support/Claude/claude_desktop_config.json.在Linux上，使用 ~/.config/Claude/claude_desktop_config.json.

下面的JSON示例使用文字占位符，如 ${GITHUB_TOKEN}。在粘贴到主机配置之前，用实际值替换它们。

例子：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@universal-mcp-toolkit/server-github", "--transport", "stdio"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@universal-mcp-toolkit/server-filesystem", "--transport", "stdio"],
      "env": {
        "FILESYSTEM_ROOTS": "${FILESYSTEM_ROOTS}"
      }
    }
  }
}

光标

生成相同的 mcpServers 代码片段并将其放入用于Cursor的MCP配置文件中。CLI保持格式主机友好和一致，因此生成的JSON作为可重用的代码段运行良好：

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@universal-mcp-toolkit/server-slack", "--transport", "stdio"],
      "env": {
        "SLACK_BOT_TOKEN": "${SLACK_BOT_TOKEN}"
      }
    },
    "linear": {
      "command": "npx",
      "args": ["-y", "@universal-mcp-toolkit/server-linear", "--transport", "stdio"],
      "env": {
        "LINEAR_API_KEY": "${LINEAR_API_KEY}"
      }
    }
  }
}

输运模型

工具包中的每台服务器都是围绕相同的传输故事设计的：

• stdio 用于本地子进程集成
• HTTP+SSE 用于远程或浏览器附近的集成
• 通过以下方式公开的发现元数据 .well-known/mcp-server.json

共享核心处理运行时引导、日志记录、环境加载和工具注册，因此每个服务器的行为都是一致的。

核心包

@universal-mcp-toolkit/core 如果你正在构建自己的MCP服务器，这是你想要学习的部分。

它包括：

• ToolkitServer 基类
• defineTool 助手
• loadEnv() 用于严格的配置验证
• HttpServiceClient 用于基于类型化获取的集成
• createServerCard() 用于查找元数据
• parseRuntimeOptions() 和 runToolkitServer() 用于stdio和HTTP+SSE启动流
• 为stderr安全服务器操作配置了pino日志记录

工程标准

• 跨工作区的TypeScript严格模式
• 用于输入和输出验证的Zod模式
• 配置、验证和上游故障的显式结构化错误
• 与导出地图和关键字一致的包清单
• 服务器卡下 .well-known/
• 用于构建、类型检查、测试和清理流的Turborepo编排

发布理念

此仓库是开发人员在询问时指向的参考实现：

• 一个严肃的MCP单回购应该是什么样子的？
• 如何记录和发现服务器包？
• 你如何保持20个集成的一致性，而不会把代码库弄得一团糟？

答案应该是：克隆此仓库，运行CLI，读取核心包，并调整所需的部分。

开发工作流程

corepack pnpm install
corepack pnpm build
corepack pnpm typecheck
corepack pnpm test

Bun（也支持）

bun install
bun run build
bun run packages/cli/dist/index.js --version

当您只想处理一个软件包时，请使用Turbo过滤器：

corepack pnpm --filter @universal-mcp-toolkit/core build
corepack pnpm --filter universal-mcp-toolkit typecheck
corepack pnpm --filter @universal-mcp-toolkit/server-github test

如果您只想了解入职流程，请从以下内容开始 docs/getting-started.html.

套餐亮点

packages/core

服务器作者共享运行时原语和严格抽象。

packages/cli

用于列出、配置、安装、运行和诊断整个工具包的操作员控制台。

servers/*

27个可独立发布的MCP服务器包，它们共享相同的操作形状。

路线图方向

monorepo是有意构建的，因此它可以在不失去连贯性的情况下增长。

• 添加更多服务器，而无需每次都发明新的架构
• 随着发现标准的发展，改进服务器卡
• 随着越来越多的MCP客户端标准化其格式，扩展主机配置模板
• 深化跨运输的烟雾和合同测试

社区

请阅读 CODE_OF_CONDUCT.md 在参与问题、拉取请求、审查或讨论之前。该项目旨在保持技术严谨，并欢迎各个经验水平的贡献者。

持久性内存

将通用mcp工具包与 备忘录 用于跨代理会话的持久、基于图的内存。

# Add persistent memory to your MCP agents
pip install memos
npm install @mem-os/sdk

# Generate a ready-to-paste MemOS MCP config
npx universal-mcp-toolkit link memos --db-path ~/.memos/memos.db

MemOS充当 存储层 对于您的MCP堆栈，您的代理生成的每个工具调用、结果和上下文都可以在重启和会话中存储、检索和搜索。MemOS MCP适配器贯穿 npx -y @mem-os/sdk mcp.

______________________________________________________________________

⭐ 明星历史


______________________________________________________________________

💬 社区使用

构建某物 universal-mcp-toolkit？我们很想知道。

打开A 讨论 告诉我们：

• 你正在建造什么
• 您正在使用哪些服务器
• 您设置的任何集成或工作流

你可能会在这里被介绍。

已知用途

• 克劳德桌面+GitHub+文件系统 --读取存储库并写入磁盘的本地开发助理
• 游标+PostgreSQL+Supabase --数据库感知AI代码完成
• 配对 备忘录 --跨会话的持久代理内存

______________________________________________________________________

📦 展示与讲述

______________________________________________________________________

许可证

麻省理工学院——见 许可证 完整条款。