← 返回目录

MCP Ts Core

社区

框架 / SDK

用于构建 MCP 服务器的 TypeScript 框架，专注于工具而非基础设施。

这是用于开发 MCP Server 或 Agent 的框架，不是可以直接连接到客户端的 Server。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 327 / 438
Stars: ★ 152 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Bun 1.3.0+
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 3 天前

43FMRS · D

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

最强项 · 文档质量 12/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

8/20

维护活跃度

10/20

文档质量

12/20

安装易用性

8/20

查看各项评分依据

可靠性 5/20: 提供的材料只有 manifest 和 README，没有 CI 工作流、已提交的测试或可执行日志；无法验证 stdio/streamable-http 能否干净启动、initialize 与 tools/list 握手是否成功，也无法核实声明工具与实际行为是否一致。README 虽描述了框架能力和错误契约，但属于不可信证据；76 个 open issues 也增加了不确定性。按照静态校准，缺少执行证据时不确定度只能降低分数，因此保守给出 5 分。
安全与权限 8/20: 未发现恶意代码、真实令牌示例或不可逆破坏性默认操作等红线问题。HTTP 默认绑定 127.0.0.1，认证默认 'none' 但仅限本机；JWT/OAuth 为可选模式，密钥通过环境变量传入。但缺少源码，无法验证 scope 检查、数据边界、存储权限与危险操作的确认机制是否实际实现；因此不给满分，也不触发红线低分，给 8 分。
维护活跃度 10/20: 仓库未归档，采用 Apache-2.0 许可证，版本为 0.11.1，README 引用 CHANGELOG 和 devcheck 开发检查命令，说明项目仍处于维护状态。但材料中没有提交/发布日期、issue 响应时间、依赖更新记录或安全响应渠道；76 个 open issues 也显示治理可能存在积压。综合给出 10 分。
文档质量 12/20: README 提供快速开始、配置表、API 概览、子路径导出、示例、测试方法和文档链接，并披露了部分限制（如 DataCanvas 在 Workers 上 fail closed）。但缺少故障排查、成本/限制说明，以及针对该 server 的可验证工具参数文档；CLAUDE.md 与 docs/ 目录内容未随材料提供，无法作为分层文档证据。给 12 分。
安装易用性 8/20: 快速开始依赖 Bun，使用 bunx 脚手架后执行 bun install；manifest 提供 stdio 和 streamable-http 两种传输及环境变量。但没有主流 MCP 客户端的配置示例，也没有 CI 或测试证明安装后可直接连接；作为框架，用户仍需自行编写工具，安装连接偏手工且无法静态验证。给 8 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件执行命令或代码访问网络连接数据库

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

安装接入

准备工作

运行环境：Bun 1.3.0+

MCP_AUTH_SECRET_KEY 可选密钥 JWT 签名密钥，使用 jwt 认证模式时必填，需自行生成保密。

OPENROUTER_API_KEY 可选密钥 OpenRouter LLM API 密钥，需在 OpenRouter 平台获取。

其他可选配置项（9 个）

MCP_TRANSPORT_TYPE 可选传输类型，stdio 或 http，默认 stdio。

MCP_LOG_LEVEL 可选最低日志输出级别（debug/info/warn 等），默认 info。

MCP_HTTP_HOST 可选 HTTP 服务器主机名，默认 127.0.0.1。

MCP_HTTP_PORT 可选 HTTP 服务器端口，默认 3010。

MCP_HTTP_ENDPOINT_PATH 可选 MCP 服务器端点路径，默认 /mcp。

MCP_AUTH_MODE 可选认证模式：none、jwt 或 oauth，默认 none。

STORAGE_PROVIDER_TYPE 可选存储后端类型：in-memory、filesystem、supabase 或 cloudflare-d1/kv/r2，默认 in-memory。

CANVAS_PROVIDER_TYPE 可选 DataCanvas 工作区类型，none 或 duckdb，默认 none。

OTEL_ENABLED 可选是否启用 OpenTelemetry 遥测，默认 false。

使用 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"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add mcp-ts-core -e MCP_LOG_LEVEL=info -- bun run start:stdio

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

这是一个用于构建 MCP 服务器的 TypeScript 框架而非可直接连接的服务器；可通过运行 `bunx @cyanheads/mcp-ts-core init my-mcp-server` 并检查生成的项目结构来验证安装是否成功。

常见排障

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

使用场景

构建自定义 MCP 服务器

将多个工具整合到一个统一的服务器中

需要认证和多租户存储的服务器

部署到 Cloudflare Workers 的服务器

支持客户端

Claude Desktop

Claude Code

依据项目文档列出，未经本站实测。

详细介绍

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

同仓库的其他 Server

源版本 72aa12efe872 数据同步于 2026-10-12 查看 FMRS 评分方法