← 返回目录
M

MCP Ts Core

社区
用于构建 MCP 服务器的 TypeScript 框架,专注于工具而非基础设施。
GitHub 源仓库 ↗
★ 148 Stars 分类 · 开发工具 热门 源版本 8b14ca68d8c0
43FMRS · D
可靠性
5/20
安全与权限
8/20
维护活跃度
10/20
文档质量
12/20
安装易用性
8/20

mcp-ts-core 是一个强大的 TypeScript 框架,适合希望构建自定义 MCP 服务器的开发者。它提供了许多内置功能(认证、存储、遥测),可显著加快开发速度。验证了 stdio 和流式 HTTP 传输,但本服务器未提供具体工具。

查看 FMRS 评分方法 →

mcp-ts-core 是一个 Agent 原生的 TypeScript 框架,用于构建 MCP 服务器。它提供声明式定义(tool、resource、prompt)、身份验证、多后端存储、OpenTelemetry 可观测性,以及对 Bun、Node 和 Cloudflare Workers 的一流支持。该框架处理传输、配置、日志、生命周期和优雅关闭等底层细节,让开发者专注于业务逻辑。

工具能力

暂未整理工具清单。

安装接入

使用 bunx @cyanheads/mcp-ts-core init my-mcp-server 初始化项目,然后 cd 进入目录并运行 bun install。

claude_desktop_config.json
{
  "mcpServers": {
    "mcp-ts-core": {
      "command": "bun",
      "args": [
        "run",
        "start:stdio"
      ],
      "env": {
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

选型与风险

适合谁

  • 使用 TypeScript 的开发团队
  • 需要快速搭建生产级 MCP 服务器
  • 需要流式 HTTP 或 stdio 传输
  • 需要 OpenTelemetry 可观测性

不适合谁

  • 不想编写代码的终端用户
  • 需要预定义业务工具集的情况
  • 仅需简单 JSON-RPC 服务(其提供了完整框架)

所需权限

  • 访问环境变量以配置服务器
  • 可能访问文件系统(用于存储)或网络(用于外部 API)
  • 如果使用 Supabase 或 Cloudflare D1/KV/R2,则需访问相应凭据

风险与副作用

  • 依赖外部服务(如 Supabase)会引入安全风险
  • 配置不当可能导致错误传输(如通过 HTTP 暴露但配置为 stdio)
  • OpenTelemetry 可能产生额外网络流量

常见排障

  1. 检查是否已安装 Bun(v1.3.0+)
  2. 尝试运行 'bun install' 确保依赖完整
  3. 检查环境设置(如 MCP_LOG_LEVEL、MCP_HTTP_PORT)
  4. 确保 .env 中的变量已正确配置

使用场景

构建自定义 MCP 服务器
将多个工具整合到一个统一的服务器中
需要认证和多租户存储的服务器
部署到 Cloudflare Workers 的服务器

支持客户端

Claude Desktop完整支持
Claude Code完整支持

同仓库的其他 Server