mcpField
M
MCP TS Quickstart

MCP TS Quickstart

本地服务
github.com/cephalization开发工具082 周前更新

关于 MCP TS Quickstart

MCP TS Quickstart 是面向 MCP 服务开发入门者的免构建 TypeScript 示例,使用 Node v23 和 stdio,并提供获取 Hacker News 热门故事的工具。

主要功能

  1. 01TypeScript MCP 服务示例
  2. 02使用 Node v23,无需构建
  3. 03stdio 传输
  4. 04Hacker News 热门故事工具
  5. 05MCP Inspector 开发流程

适用场景

  1. 01启动 TypeScript MCP 服务项目
  2. 02开发时检查并重启服务
  3. 03改造 topStories 工具以实现其他用途

MCP 相关

它通过 stdio 实现 MCP 服务,并提供获取 Hacker News 热门故事的工具。可配置给 Claude Desktop,也可搭配 MCP Inspector 使用。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

MCP TS 快速入门

这是 TypeScript 版 MCP 快速入门。

其中包含一个基本的 MCP 服务实现,使用 stdio 传输方式, 并获取 Hacker News 上的热门故事。

它使用 TypeScript 编写,通过利用 Node v23,无需构建步骤即可运行。

基于 MCP 文档中提供的示例。

预览

用法

以下代码片段需要 git、nvm 和 pnpm。

git clone [email protected]:cephalization/mcp-ts-quickstart.git
cd mcp-ts-quickstart
nvm install && nvm use
pnpm install

克隆仓库并安装依赖项后,你可以使用类似以下配置将此服务添加到 Claude Desktop:

{
  "mcpServers": {
    "hacker-news": {
      "command": "/Users/tony/.nvm/versions/node/v23.6.0/bin/node",
      "args": ["/Users/tony/repos/mcp/src/index.ts"]
    }
  }
}

如需详细了解如何将 Claude Desktop 用作客户端,请参阅 MCP 文档。

开发

以下命令将安装依赖项,然后启动 MCP 服务,并使用 MCP Inspector UI 作为客户端。

nvm install && nvm use
pnpm install
pnpm start

由于该服务无需构建,你只需在 Inspector UI 中按下“Restart”按钮即可“重启”服务。

扩展服务

服务实现在 src/index.ts 中。

topStories 工具实现在 src/tools.ts 中。

若要添加新工具,你可以复制 topStories 工具并进行修改。

导入本地 src 文件时,请确保使用 .ts 扩展名,以便 node 能够解析。

导入类型时,请确保在导入前添加 type 关键字,以便 node 能在运行时将其剥离。

导入库时,如果库未提供 exports 映射,请确保导入实际的源文件扩展名。

MCP Inspector

MCP Inspector 是一个用于与 MCP 服务交互的 UI。

运行后,可通过 http://localhost:6274 访问。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。