Unified MCP API

统一MCP API

一个统一的REST API，取代了Claude Code的MCP（模型上下文协议）服务器，每次会话减少了约32000个令牌的上下文开销。

目的

这个API通过REST端点提供了Claude可以访问的相同功能，而不是将16+MCP服务器和134个工具加载到Claude的上下文中 WebFetch.

快速开始

# Install dependencies
npm install

# Copy environment template
cp .env.example .env

# Configure your API keys in .env

# Run in development
npm run dev

# Build for production
npm run build
npm start

部署

此API旨在部署到 渲染:

1. 推送到GitHub
2. 将存储库连接到Render
3. 配置环境变量
4. 部署

看 render.yaml 部署蓝图。

API终点

所有端点都需要 Authorization: Bearer YOUR_API_KEY 头球

健康检查

• GET /health -无需身份验证

API信息

• GET /api/v1 -列出所有可用端点

GitHub(/api/v1/github)

• GET /repos/search?q= -搜索存储库
• GET /repos/:owner/:repo -获取存储库
• GET /repos/:owner/:repo/contents/* -获取文件内容
• PUT /repos/:owner/:repo/contents/* -创建/更新文件
• GET /repos/:owner/:repo/commits -列表提交
• GET /repos/:owner/:repo/issues -列出问题
• POST /repos/:owner/:repo/issues -创建问题
• PATCH /repos/:owner/:repo/issues/:number -更新问题
• GET /repos/:owner/:repo/pulls -列出拉取请求
• POST /repos/:owner/:repo/pulls -创建pull请求
• PUT /repos/:owner/:repo/pulls/:number/merge -合并PR
• POST /repos/:owner/:repo/branches -创建分支
• GET /search/code?q= -搜索代码
• GET /search/issues?q= -搜索问题

概念(/api/v1/notion)

• GET /search?q= -搜索工作区
• GET /pages/:id -获取页面
• POST /pages -创建页面
• PATCH /pages/:id -更新页面
• GET /pages/:id/blocks -获取页面块
• POST /pages/:id/blocks -附加块
• GET /databases/:id -获取数据库
• POST /databases/:id/query -查询数据库
• POST /databases -创建数据库
• GET /users -列出用户
• POST /comments -创建评论

文件系统(/api/v1/fs)

• GET /allowed -列出允许的目录
• GET /read?path= -读取文件
• POST /write -写入文件
• PATCH /edit -编辑文件（查找/替换）
• GET /list?path= -列表目录
• GET /tree?path= -目录树
• GET /search?path=&pattern= -搜索文件
• GET /info?path= -文件信息
• POST /mkdir -创建目录
• POST /move -移动/重命名文件
• DELETE /delete?path= -删除文件

记忆/知识图谱(/api/v1/memory)

• GET / -阅读整个图表
• POST /entities -创建实体
• POST /relations -建立关系
• POST /observations -添加观察结果
• DELETE /entities -删除实体
• DELETE /observations -删除观察结果
• DELETE /relations -删除关系
• GET /search?query= -搜索节点
• POST /nodes -打开特定节点

SQLite数据库(/api/v1/db)

• GET /tables -列出表格
• GET /tables/:name -描述表格
• POST /tables -创建表格
• POST /query/read -执行SELECT
• POST /query/write -执行插入/更新/删除
• POST /query/raw -原始SQL（管理员）
• POST /transaction -交易支持
• POST /insights -添加业务洞察力
• GET /insights -获取见解

文件(/api/v1/docs)

• GET /resolve?libraryName= -解析库ID
• GET /library?libraryId= -获取库文档
• GET /search?query= -搜索文档
• GET /popular -热门图书馆
• GET /examples?libraryId= -代码示例

浏览器自动化(/api/v1/browser)

• POST /navigate -导航到URL
• POST /screenshot -截图
• GET /snapshot -可访问性快照
• POST /click -点击元素
• POST /type -键入文本
• POST /fill-form -填写表单字段
• POST /press -按键
• POST /evaluate -运行JavaScript
• GET /content -获取页面内容
• POST /wait -等待选择器
• POST /resize -调整视口大小
• POST /close -结束会话
• GET /tabs -列表选项卡

渲染部署(/api/v1/render)

• GET /services -列出服务
• GET /services/:id -获取服务
• POST /services/web -创建web服务
• POST /services/static -创建静态站点
• PATCH /services/:id -更新服务
• GET /services/:id/deploys -列表部署
• POST /services/:id/deploys -触发器部署
• PUT /services/:id/env-vars -更新环境变量
• GET /postgres -列出数据库
• POST /postgres -创建Postgres
• GET /key-value -列出Redis存储
• GET /metrics/:id -获取指标
• GET /logs/:id -获取日志

特雷洛(/api/v1/trello)

• GET /boards -列表板
• GET /boards/:id -获取董事会
• GET /boards/:id/lists -获取列表
• POST /lists -创建列表
• GET /lists/:id/cards -获取卡片
• GET /cards/:id -获取卡片
• POST /cards -创建卡片
• PUT /cards/:id -更新卡片
• PUT /cards/:id/move -移动卡片
• DELETE /cards/:id -删除卡片
• POST /cards/:id/comments -添加评论
• GET /search?query= -搜索

不和谐(/api/v1/discord)

• GET /me -获取机器人信息
• GET /guilds -列出公会
• GET /guilds/:id/channels -获取频道
• GET /channels/:id/messages -获取消息
• POST /channels/:id/messages -发送消息
• PATCH /channels/:id/messages/:id -编辑消息
• DELETE /channels/:id/messages/:id -删除邮件
• POST /channels/:id/threads -创建线程
• POST /webhooks/:id/:token -Webhook消息

顺序思维(/api/v1/thinking)

• POST /sessions -创建会话
• GET /sessions -列出会话
• GET /sessions/:id -获取会话
• POST /sessions/:id/thoughts -添加想法
• POST /think -过程思维
• GET /sessions/:id/summary -获取摘要
• DELETE /sessions/:id -删除会话

环境变量

# Server
PORT=3000
NODE_ENV=development
API_KEY=your-secure-api-key

# Service Tokens
GITHUB_TOKEN=ghp_...
NOTION_TOKEN=secret_...
RENDER_API_KEY=rnd_...
TRELLO_API_KEY=...
TRELLO_TOKEN=...
DISCORD_BOT_TOKEN=...

# Paths
ALLOWED_PATHS=D:/GitFolder,D:/Research
SQLITE_DB_PATH=./data/database.db
MEMORY_GRAPH_PATH=./data/knowledge-graph.json
THINKING_SESSIONS_PATH=./data/thinking-sessions.json

# Logging
LOG_LEVEL=info

建筑

src/
├── index.ts              # Express app entry point
├── middleware/
│   ├── auth.ts           # API key authentication
│   └── errorHandler.ts   # Error handling
├── routes/
│   ├── github.ts         # GitHub API
│   ├── notion.ts         # Notion API
│   ├── filesystem.ts     # File operations
│   ├── memory.ts         # Knowledge graph
│   ├── database.ts       # SQLite
│   ├── docs.ts           # Context7 proxy
│   ├── browser.ts        # Playwright
│   ├── render.ts         # Render.com
│   ├── trello.ts         # Trello
│   ├── discord.ts        # Discord
│   └── thinking.ts       # Sequential thinking
└── utils/
    └── logger.ts         # Winston logger

代币节省

许可证

麻省理工学院