使用说明
🌌 MCP宇宙
🌌 MCP宇宙
将AI代理连接到MCP服务器的最快自托管方式——具有统一网关、信任感知工具发现、会话共享和零供应商锁定。
MCP Universe是一个开发人员优先的平台，用于通过一个自托管的控制平面发现、连接、管理和运行MCP工具。
它专为想要：
- 一个地方连接多个MCP服务器
- 干净的开发人员体验
- 安全、策略感知的工具执行
- 用于测试的视觉游乐场
- 一种自托管的替代供应商锁定的MCP平台
为什么选择MCP宇宙？
目前，大多数MCP工作流程都是分散的：
- 一种发现工具
- 另一个用于网关
- 另一个用于身份验证
- 另一个用于测试
- 另一个用于会话共享
MCP宇宙 旨在将其统一到一个产品中：
- 统一MCP网关 --在一个端点后连接多个MCP服务器
- 信任感知工具发现 --使用置信度元数据对工具进行排名和公开
- 会话共享 --按URL保存和共享可复制的工具会话
- 视觉游乐场 --检查工具，运行它们，并验证行为
- 默认情况下为自托管 --拥有自己的堆栈、凭据、日志和策略
- 零供应商锁定 --开放式架构，标准MCP集成模型
当前状态
MCP Universe正在积极开发中。
工作重点
- 自托管部署
- 统一网关架构
- 多业务平台基础
- 对贡献者友好的路线图
- 安全第一MCP聚合
进行中
- 已验证端到端快速入门
- SDK/包发布
- 信任评分用户体验
- 会话共享用户体验
- 可观察性和审计跟踪
计划的
- 注册表/发现层
- 工具级授权的策略引擎
- 高级身份验证流程
- 生产级指标和仪表板
如果你想帮助制定路线图，请参阅 贡献.
核心产品愿景
MCP Universe围绕五个产品支柱构建：
1.一个网关用于多个MCP服务器
通过单个控制平面连接远程、本地、容器化和托管的MCP服务器。
2.实际感觉简单的开发人员体验
承诺不是“更多的基础设施” 承诺是： 想法和工作工具调用之间的摩擦更小.
3.默认安全
真正的MCP网关必须做的不仅仅是代理流量。 它必须强制执行身份验证，验证请求，限制风险，并使工具使用可观察。
4.信任意识执行
并非所有工具都同样可靠。 MCP Universe旨在帮助代理和开发人员了解哪些工具更安全、更稳定、更值得信赖。
5.可共享、可复制的会议
如果一个工具工作流只工作一次，您应该能够保存、检查和共享它。
快速开始
目标：使MCP Universe在本地运行，并验证一个成功的工具流。
先决条件
- 码头工人
- Docker Compose
- Git
设置
git clone https://github.com/Ojk2026/Mcp-universe-improved.git
cd Mcp-universe-improved
cp .env.example .env
docker compose up -d --build
> Maailman yksinkertaisin tapa yhdistää tekoäly kaikkiin MCP-palvelimiin.
[](LICENSE)
[](https://www.npmjs.com/package/mcp-universe)
[](docker-compose.yml)
[](https://github.com/OJKotkaLKP/MCP-UNIVERSE-/actions)
---
## Miksi MCP UNIVERSE?
| Ominaisuus | MCP UNIVERSE | MetaMCP | Smithery | Magg |
|---|---|---|---|---|
| JS SDK — 3 riviä | ✅ | ❌ | ❌ | ❌ |
| Yksi `docker-compose up` | ✅ | ⚠️ | ❌ | ❌ |
| Self-hosted | ✅ | ✅ | ❌ | ✅ |
| Visuaalinen playground | ✅ | ⚠️ | ✅ | ❌ |
| Luottamuspistytys | ✅ | ❌ | ❌ | ❌ |
| Sessioiden jako URL:lla | ✅ | ❌ | ❌ | ❌ |
| Ilmainen & avoin | ✅ | ✅ | ❌ | ✅ |
---
## ⚡ Quick Start — 60 sekuntia
### Vaihtoehto 1: JavaScript SDK
```bash
npm install mcp-universe
import { MCPUniverse } from 'mcp-universe';
const universe = new MCPUniverse({ gateway: 'http://localhost:3000' });
const result = await universe.run('hae säätiedot Helsingistä');
console.log(result);
就这样 宇宙会自动找到合适的工具。
选项 2：Docker（整个系统）
git clone https://github.com/OJKotkaLKP/MCP-UNIVERSE-.git
cd MCP-UNIVERSE-
cp .env.example .env
docker-compose up -d
open http://localhost:8080
📦 JS SDK - 所有功能
安装
npm install mcp-universe # tai yarn / pnpm
基本连接
import { MCPUniverse } from 'mcp-universe';
const universe = new MCPUniverse({
gateway: 'http://localhost:3000',
apiKey: 'optional-api-key',
});
添加 MCP 服务器
// SSE-palvelin
await universe.connect({ name: 'my-tools', transport: 'sse',
url: 'https://my-server.com/sse' });
// STDIO (lokaalisti)
await universe.connect({ name: 'files', transport: 'stdio',
command: 'npx', args: ['-y', '@modelcontextprotocol/server-filesystem', '/tmp'] });
// Docker
await universe.connect({ name: 'browser', transport: 'docker',
image: 'mcp/playwright:latest' });
使用
// Listaa kaikki saatavilla olevat työkalut luottamuspisteineen
const tools = await universe.tools();
// [{ name: 'read_file', server: 'files', trust: 0.98 }, ...]
// Aja työkalu suoraan
const result = await universe.call('read_file', { path: '/tmp/hello.txt' });
// Luonnollisella kielellä — Universe valitsee työkalut itse
const answer = await universe.run('lue /tmp/hello.txt ja tiivistä');
// Jaa sessio URL:lla
const { url } = await universe.session.save();
// https://your-instance/s/abc123
TypeScript
import { MCPUniverse, Tool, Session } from 'mcp-universe';
// Täysi tyyppituki automaattisesti
🏗️ 建筑
Internet → Frontend :8080 (ainoa julkinen portti)
│
┌───────┴────────┐
▼ ▼
Nexus Gateway Session Manager
(Rust) (Flask)
│ │
└───────┬─────────┘
│
┌───────┴────────┐
▼ ▼
PostgreSQL Redis
(Trust Graph) (Sessions)
🔒 信息安全
- 所有帐户中的非 root 用户
- PostgreSQL和Redis不能公开使用
- 所有端点的速率限制
- 网关上的 JWT 身份验证
- CSP、HSTS 和其他 HTTP 安全框架
🤝 参与
- Fork → 特征分支→ PR
- 看 贡献.md
📄 许可证
麻省 理工 学院© 父亲
