一个生产级的 TypeScript MCP 服务器，为 AI 代理（Claude Desktop、Cursor、Windsurf、自定义代理）提供跨四个领域的结构化真实世界数据访问：金融市场、Web3/DeFi、开发者工具和医疗保健 (FHIR)。
身份验证优先 — 默认启用 JWT 验证
域隔离 — 缺少 API 密钥只会禁用单个域，而不会影响整个服务器
响应缓存 (LRU + TTL) 和每个域的令牌桶速率限制
每个工具输入和输出均采用类型化模式 (Zod)
两种传输方式：stdio（本地）和 HTTP + SSE（远程/托管）
# Run directly (no global install required)
npx mcp-suite
# Or install globally
npm install -g mcp-suite
mcp-suite要求： Node.js ≥ 20, npm ≥ 10
Related MCP server: APIbase
将 .env.example 复制为 .env 并填入您想要启用的域的密钥：
cp .env.example .env# Authentication (required in production)
MCP_JWT_SECRET=your-secret-here
# Financial Markets (Alpha Vantage + CoinGecko)
ALPHA_VANTAGE_API_KEY=
# Web3 / DeFi (Alchemy + OpenSea + Blur)
ALCHEMY_API_KEY=
OPENSEA_API_KEY=
# Developer Tools (GitHub)
GITHUB_TOKEN=
# Healthcare / FHIR (optional — defaults to public HAPI sandbox)
FHIR_BASE_URL=https://hapi.fhir.org/baseR4
# Server
LOG_LEVEL=info # debug | info | warn | error
MCP_PORT=3000 # HTTP transport only
AUTH_DISABLED=false # set true for local dev only您只需要为您使用的域提供密钥。缺少密钥的域在启动时会被静默禁用。
npx mcp-suite gen-token
# eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)：
{
"mcpServers": {
"mcp-suite": {
"command": "npx",
"args": ["mcp-suite"],
"env": {
"MCP_JWT_SECRET": "your-secret-here",
"ALPHA_VANTAGE_API_KEY": "...",
"ALCHEMY_API_KEY": "...",
"OPENSEA_API_KEY": "...",
"GITHUB_TOKEN": "..."
}
}
}
}npx mcp-suite --transport http --port 3000这将暴露 GET /health、GET /tools 以及用于远程 MCP 客户端的 SSE 端点。
命令 | 描述 |
| 启动服务器（stdio 传输，默认） |
| 启动 HTTP + SSE 服务器 |
| 生成开发用 JWT |
| 打印所有按域分组的活动工具 |
由 Alpha Vantage 和 CoinGecko 提供支持。
需要：ALPHA_VANTAGE_API_KEY
工具 | 描述 |
| 美股价格、成交量、涨跌幅 % |
| 货币对汇率 (ISO 4217) |
| 加密货币价格、市值、24小时涨跌幅 |
| 带有情绪评分的金融头条新闻 |
示例：
{ "tool": "get_stock_quote", "arguments": { "ticker": "NVDA" } }由 Alchemy、OpenSea 和 Blur 提供支持。
需要：ALCHEMY_API_KEY, OPENSEA_API_KEY
工具 | 描述 |
| OpenSea + Blur 上的最佳地板价 (ETH, Base, Arbitrum) |
| 最近 N 笔带有特征和市场信息的销售记录 |
| 多链代币 + NFT 持仓，ENS 解析 |
| Uniswap V2/V3 池储备和价格比率 |
| 每笔交易的滑点估算 |
示例：
{ "tool": "get_nft_floor", "arguments": { "collection_slug": "boredapeyachtclub" } }由 GitHub API 提供支持。
需要：GITHUB_TOKEN
工具 | 描述 |
| 星标、分支、问题、语言、最后一次提交 |
| PR 差异摘要、审查者、CI 检查、合并状态 |
| 每个分支的最新 GitHub Actions 运行情况 |
| 活动部署 URL 和状态 |
示例：
{ "tool": "get_pipeline_status", "arguments": { "repo": "vercel/next.js", "branch": "canary" } }由 HAPI FHIR R4 提供支持。
需要：无（默认为公共沙箱）或自定义端点的 FHIR_BASE_URL。
HIPAA 注意事项： 所有医疗保健工具仅连接到仅包含合成数据的公共沙箱。不会访问任何真实的患者健康信息 (PHI)。对于生产环境，请将
FHIR_BASE_URL替换为符合 HIPAA 标准的 EHR 端点，并配置适当的 SMART on FHIR OAuth 2.0 凭据。
工具 | 描述 |
| 人口统计学患者搜索 |
| 按患者查询生命体征和实验室结果 |
| 按患者查询活动药物列表 |
示例：
{ "tool": "lookup_patient", "arguments": { "name": "Smith", "birth_date": "1980-01-15" } }身份验证默认启用。每次工具调用都必须携带有效的 JWT。
将 MCP_JWT_SECRET 设置为一个强密钥。在生产模式下，如果没有该密钥，服务器将拒绝启动。
选项 A — 完全禁用身份验证（仅限本地）：
AUTH_DISABLED=true选项 B — 使用开发 JWT：
npx mcp-suite gen-token在 MCP 请求的 _meta 字段（stdio）或 Authorization: Bearer 标头（HTTP）中传递生成的令牌。
{
"sub": "your-client-id",
"scope": "mcp:tools",
"iat": 1713484800,
"exp": 1716076800
}MCP Clients (Claude Desktop · Cursor · Windsurf · Custom Agents)
│ MCP Protocol
┌───────▼────────────────────────────────────────┐
│ Transport Layer (stdio | HTTP + SSE) │
├────────────────────────────────────────────────┤
│ Auth Middleware (JWT validation / bypass) │
├────────────────────────────────────────────────┤
│ Tool Registry (register · list · route) │
├──────────┬──────────┬──────────┬───────────────┤
│Financial │ Web3 │ DevTools │ Healthcare │
├──────────┴──────────┴──────────┴───────────────┤
│ Shared: Rate Limiter · Cache · Logger · Errors │
└─────────────────────────────────────────────────┘
│ │ │ │
Alpha Vantage Alchemy GitHub API HAPI FHIR
CoinGecko OpenSea
Blur缓存： 进程内 LRU + TTL 缓存 (node-cache)。TTL 根据域进行调整（加密货币为 15 秒，GitHub 仓库统计为 300 秒）。
速率限制： 每个域的令牌桶保护免费层 API 配额。
错误类型： AuthError、ValidationError、DomainUnavailableError、UpstreamError、RateLimitError — 全部生成结构化的 MCP 错误响应。
日志记录： 每次工具调用均记录结构化 JSON：域、工具名称、延迟、缓存命中、状态。
每个域遵循相同的模式。要添加新域：
在 src/domains/[name]/ 中创建 index.ts、schemas.ts、client.ts 和 tools/
导出一个 Domain 对象：
export const myDomain: Domain = {
name: 'my-domain',
isAvailable: () => !!config.MY_API_KEY,
registerTools: (server) => { /* server.tool(...) calls */ }
}在 src/server.ts 中注册它
在 docs/API.md 中记录工具
请参阅 docs/TDD.md §5 和 docs/CODING_STANDARDS.md 以获取完整模式。
git clone https://github.com/ayenisholah/mcp-suite.git
cd mcp-suite
npm install
cp .env.example .env # fill in your API keys
npm run build # compile TypeScript → dist/
npm run dev # watch mode
npm run typecheck # type check without emit
npm run lint # ESLint
npm test # unit tests (Vitest)
npm run test:coverage # tests + coverage report
# Integration tests — hits real APIs, requires .env keys
RUN_INTEGRATION=true npm test当使用 --transport http 运行时：
端点 | 身份验证 | 描述 |
| 否 | 每个域的可用性状态 |
| 是 | 所有已注册的工具，按域分组 |
| 是 | MCP 协议端点 (SSE) |
代码 | 描述 |
| JWT 缺失、过期或签名无效 |
| 输入未通过 Zod 模式验证 |
| 启动时未配置域 API 密钥 |
| 超出每个域的速率限制 |
| 外部 API 返回错误或超时 |
MIT — 请参阅 LICENSE
欢迎提交问题和 PR。提交前请阅读 docs/CODING_STANDARDS.md。
This server cannot be deployed
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Hosted MCP server for live public-data APIs and Skills for AI agents.
MCP server giving AI agents one-connection access to crypto & DeFi data: DeFi protocol TVL, stableco
Discover and call 10,000+ production APIs from one MCP server. Pay-per-call billing for AI agents.
