← 返回目录

MCP TypeScript Core Server

社区

框架 / SDK

Agent 原生的 TypeScript MCP 服务器框架

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

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

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

33FMRS · D

该服务器是一个脚手架，由 mcp-ts-core 框架提供支持，目前不包含预定义的工具。它适合开发者作为起点，但不适合非技术用户直接使用。

最强项 · 文档质量 10/20 最弱项 · 可靠性 2/20

可靠性

2/20

安全与权限

8/20

维护活跃度

10/20

文档质量

10/20

安装易用性

3/20

查看各项评分依据

可靠性 2/20: 模板 server.json 使用 {{PACKAGE_NAME}} 占位符且 repository.url 为空，无法直接安装或启动；清单中未声明任何工具，无法验证 init/tools-list 握手或工具行为。README 声称框架可自动处理生命周期，但这是框架级描述，且没有任何提交的 CI 或测试证据用于该模板服务器。版本号 0.1.0 与 README 的 0.11.1 不一致。因此只能给很低分。
安全与权限 8/20: 未发现恶意代码、凭据泄露或危险默认操作；HTTP 默认绑定 127.0.0.1，认证默认 none，未在清单中硬编码密钥。但清单没有包含 MCP_AUTH_SECRET_KEY 等认证所需变量，工具定义缺失导致无法评估最小权限、确认机制和数据边界；框架的 auth/storage 能力不能自动等同于该模板服务器的安全姿态。
维护活跃度 10/20: 仓库未归档、有 Apache-2.0 许可证、README 显示版本 0.11.1 并链接 CHANGELOG，说明项目仍在维护。但缺少提交频率、问题响应时间和依赖更新证据，且清单版本 0.1.0 与 README 版本不一致，存在版本治理缺口，因此按 10 分处理。
文档质量 10/20: README 对框架本身提供了较丰富的分层文档（快速开始、配置表、API、测试、遥测文档链接），但对 templates/server.json 这个具体服务器几乎没有针对性说明：描述为空、无工具参数说明、无故障排查、无客户端接入示例。文档与清单占位符之间也有隐性假设，因此不能给更高分。
安装易用性 3/20: 该清单是模板而非可执行服务器：包名是 {{PACKAGE_NAME}} 占位符，npm 包参数无法直接运行；README 的快速开始是 bunx init，不是针对此清单的安装步骤，也没有给出主流客户端配置示例。静态校准要求最高 15，且缺少 CI/测试执行证据，实际安装路径不清晰，故给 3 分。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络连接数据库

适合谁

希望快速搭建 MCP 服务器的 TypeScript 开发者
需要可扩展 MCP 服务器基础设施的团队
实验性项目或概念验证

不适合谁

需要开箱即用生产工具的最终用户
需要现成领域特定功能的场景
不希望自行开发工具定义的场景

所需权限

网络访问（如果工具调用外部 API）
文件系统访问（取决于存储后端）
环境变量配置

风险与副作用

框架可能仍处于积极开发阶段，API 可能发生变化
默认安全配置可能不足，需要根据生产需求调整
依赖项可能引入漏洞，需定期更新

安装接入

准备工作

运行环境：Node.js · 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_HTTP_PORT 可选 HTTP 服务器端口，默认 3010。

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

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

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

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

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

CANVAS_PROVIDER_TYPE 可选 DataCanvas 后端：none 或 duckdb（需可选依赖 @duckdb/node-api），默认 none。

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

确保已安装 Node.js 和 npm。
使用 npx -y @cyanheads/mcp-ts-core run start:stdio 启动服务器。
根据需要设置环境变量（如 MCP_LOG_LEVEL）。

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-ts-core-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/mcp-ts-core",
        "run",
        "start:stdio"
      ],
      "env": {
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

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

.vscode/mcp.json

{
  "servers": {
    "mcp-ts-core-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/mcp-ts-core",
        "run",
        "start:stdio"
      ],
      "env": {
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

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

Terminal

claude mcp add mcp-ts-core-server -e MCP_LOG_LEVEL=info -- npx -y @cyanheads/mcp-ts-core run start:stdio

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

生成并校验客户端配置

验证是否装好

这是用于构建 MCP 服务器的框架/SDK，而非终端用户直接连接的服务器；请按快速开始运行 `bunx @cyanheads/mcp-ts-core init my-mcp-server` 并确认项目脚手架生成成功。由于未记录任何工具，无法给出工具列表验证步骤。

常见排障

确保 Node.js 版本兼容（^7.0.2 TypeScript 建议）
检查环境变量是否正确设置
查看日志（MCP_LOG_LEVEL）以获取错误信息

使用场景

作为使用 TypeScript 构建 MCP 服务器的起点

用于测试 MCP 客户端与基于框架的服务器之间的交互

作为开发自定义 MCP 服务器的脚手架

支持客户端

Claude Desktop

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

详细介绍

这是一个脚手架服务器，由 @cyanheads/mcp-ts-core 框架生成，该框架用于构建 MCP 服务器。框架本身提供声明式定义（工具、资源、提示）、认证（JWT/OAuth）、多后端存储（内存、文件系统、Supabase、Cloudflare D1/KV/R2）、OpenTelemetry 可观测性，以及对 Bun、Node.js 和 Cloudflare Workers 的一流支持。此服务器作为框架能力的演示，实际工具由开发者在生成的项目中定义。

同仓库的其他 Server

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