mcpField
T
Template for MCP Server

Template for MCP Server

本地服务
github.com/bladnman开发工具286 周前更新
代码仓库

关于 Template for MCP Server

这是一个用于派生新项目的 MCP 服务模板，面向希望搭建 TypeScript MCP 服务的开发者。它提供字符串反转工具、示例资源以及 stdio 和 SSE 传输支持。

主要功能

  1. 01字符串反转工具
  2. 02stdio 与 SSE 传输
  3. 03TypeScript 构建流程
  4. 04问候与服务信息资源

适用场景

  1. 01基于模板创建 MCP 服务项目
  2. 02测试字符串反转工具
  3. 03使用 MCP Inspector 检查消息传输

MCP 相关

模板示例实现了 MCP 服务，向客户端提供字符串反转工具和问候、服务信息资源，并支持 stdio 与 SSE 传输。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "template-bladnman": {
      "command": "npx",
      "args": [
        "-y",
        "make-mine"
      ]
    }
  }
}
启动命令npx -y make-mine

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmmake-mine

工具

还没有获取到工具列表

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

详细介绍

MCP 服务模板

MCP 服务的起点。

复制我

这里的核心是让你将其用于自己的项目。 运行此命令以创建一个包含此模板副本的新文件夹 （移除 git 并替换为新的 git 仓库）。

将 mcp-server 替换为你选择的名称：

npx make-mine https://github.com/bladnman/mcp-server-template.git <mcp-server>

功能

  • 简单的字符串反转工具
  • 支持 stdio 和 SSE 两种传输方式
  • 使用 TypeScript 实现，包含完整的构建流程

工具

reverse

接收字符串输入并返回反转后的字符串。

示例：

  • 输入：“hello world”
  • 输出：“dlrow olleh”

资源

  • greeting://hello：欢迎问候语
  • welcome://info：有关服务及其功能的信息

开始使用

使用 MCP Inspector 进行测试

你可以使用通用检查工具来测试服务本身， 该工具可以让你查看服务与客户端之间传输的消息。 在 shell 中运行以下命令即可。

npx fastmcp inspect server.ts

然后访问它提供的 URL（可能是）： http://localhost:5173

对于我们当前运行的这个服务，我们需要在根目录中 以 stdio 模式、且不带参数，执行 server.sh 文件。

<full_path_to_server>/run-server.sh
前提条件
  • Node.js（v14 或更高版本）
  • npm
安装
# Install dependencies
npm install
运行服务
# Build and run with stdio transport (default)
bash run-server.sh

# Or, to run with SSE transport
TRANSPORT_TYPE=sse npm run start

默认情况下，SSE 服务运行在端口 4000。可在 CONST.ts 文件中更改。

开发

# Run in development mode with hot reloading
npm run dev

# Watch for changes and rebuild automatically
npm run watch

构建

# Build TypeScript to JavaScript
npm run build

构建后的文件将位于 dist 目录中。

许可证

ISC 许可证

评论

支持 Markdown

第一次接触 MCP？

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

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