mcp-ts-core
一个用于构建MCP服务器的TypeScript框架，专注于工具开发而非基础设施。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：mcp-ts-core。 它的用途是：一个用于构建MCP服务器的TypeScript框架，专注于工具开发而非基础设施。 完整的 Skill 内容见：https://321skill.com/skills/mcp-ts-core/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
作为开发者，你无需直接对AI说指令来使用此框架。相反，你会在你的代码编辑器中编写类似示例的TypeScript代码。例如，当你需要为团队创建一个内部知识库查询工具时，你可以使用此框架定义工具的描述、输入参数和查询逻辑。框架会自动处理与Claude Desktop等客户端的通信，使你的团队能直接在AI对话中查询知识库。
介绍
@cyanheads/mcp-ts-core 是一个专为构建Model Context Protocol (MCP) 服务器设计的TypeScript框架。它旨在解决开发者在创建AI Agent工具时面临的基础设施复杂性，如认证、配置、日志记录、遥测和多后端存储等问题，让开发者能专注于工具本身的业务逻辑。
使用方式非常直观：开发者通过声明式的方式定义工具、资源和提示词，框架会自动处理底层的通信、序列化和生命周期管理。如上方的代码示例，开发者只需定义工具的行为、输入输出格式以及可能的错误和附加信息，框架便会生成一个功能完整的MCP服务器。
这个框架非常适合那些希望为AI Agent（如Claude Desktop、Cursor等）开发自定义工具的后端或全栈开发者。它尤其适合需要在Bun、Node.js或Cloudflare Workers等多种运行时环境中部署服务的团队。
建议在项目初期就引入此框架，以统一工具开发的范式。需要注意，它本身不是一个可以直接调用的工具，而是一个开发框架，因此需要具备一定的TypeScript和Node.js开发基础才能有效使用。
核心特点
其核心区别在于提供了声明式的工具定义和强类型的错误与信息富集（enrichment）合约，这些信息能同时适配支持`structuredContent`和`content[]`的客户端，无需开发者手动适配。同时，它深度集成了OpenTelemetry、多后端存储和认证等生产级基础设施。
注意事项
不适合没有TypeScript/Node.js开发经验的用户直接使用，因为它是一个开发框架而非开箱即用的工具。
常见问题
这个框架和官方的MCP TypeScript SDK有什么区别？
官方SDK提供了基础的MCP协议实现，而此框架在SDK之上构建，提供了更高层次的抽象、声明式API、内置的生产级功能（如认证、存储、遥测）和开发最佳实践，旨在提升开发效率和代码质量。
可以用它来开发哪些类型的工具？
可以开发任何能与MCP客户端交互的工具，例如连接数据库、调用外部API、处理文件、执行计算等，适用于开发AI应用、搭建个人知识库、管理项目文档、执行自动化部署等多种场景。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/mcp-ts-core/raw/index.md 读取 mcp-ts-core 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/mcp-ts-core/raw/index.md（查看排版版本）