FastMCP Greeting Server

这是一个基于Node.js和MCP SDK的FastMCP脚手架项目，包含一个简单的greeting工具示例。

📚 快速导航

• MCP 配置文档 - 如何在 Claude Desktop 等客户端中配置使用
• npm 发布指南 - 如何发布到 npm 仓库
• 快速开始 - 快速上手指南

功能特性

• ✅ 基于TypeScript开发
• ✅ 使用MCP SDK (官方Model Context Protocol SDK)
• ✅ 支持多语言问候(中文/英文)
• ✅ 包含工具和资源示例
• ✅ 使用stdio传输协议
• ✅ 内置测试客户端

安装依赖

从 npm 安装（推荐）

npm install -g @your-username/fastmcp-greeting-server

安装后可直接使用：

fastmcp-greeting

本地开发安装

克隆项目并安装依赖：

git clone https://github.com/your-username/fastmcp-demo.git
cd fastmcp-demo
npm install

使用方法

开发模式运行

npm run dev

构建项目

npm run build

运行构建后的项目

npm start

运行测试

执行内置的测试客户端，测试greeting功能：

npm test

测试将会：

• 连接到MCP服务器
• 列出可用的工具
• 测试英文问候
• 测试中文问候
• 测试默认语言
• 列出可用资源
• 读取帮助文档

工具说明

greeting 工具

向指定用户发送问候语。

参数：

• name (必需): 要问候的人的名字
• language (可选): 问候语言，支持 'zh'(中文) 或 'en'(英文)，默认为英文

示例：

{
  "name": "Alice",
  "language": "en"
}

资源说明

greeting://help

查看greeting工具的使用帮助文档。

项目结构

fastdemo/
├── src/
│   ├── index.ts          # 主服务器文件
│   └── test-client.ts    # 测试客户端
├── dist/                 # 编译输出目录
├── node_modules/         # 依赖包
├── package.json          # 项目配置
├── tsconfig.json         # TypeScript配置
├── .gitignore           # Git忽略文件
└── README.md            # 项目说明

技术栈

• @modelcontextprotocol/sdk 1.x (官方MCP SDK)
• TypeScript 5.x
• Node.js 20+
• Zod (参数校验)

License

MIT

🔗 相关链接

• npm 包: https://www.npmjs.com/package/@your-username/fastmcp-greeting-server
• GitHub 仓库: https://github.com/your-username/fastmcp-demo
• 问题反馈: https://github.com/your-username/fastmcp-demo/issues
• MCP 官方文档: https://modelcontextprotocol.io/

👉 接下来做什么？

1. 📝 查看 MCP_CONFIG.md 在 Claude Desktop 中配置使用
2. 🚀 查看 NPM_PUBLISH.md 将你的服务器发布到 npm
3. 🛠️ 基于这个脚手架添加更多工具和资源

注意: 请将文档中的 @your-username 替换为你的实际 npm 用户名或 GitHub 用户名。