
MCP サーバー/クライアント サンプル

2025.03.26
0
TypeScriptMCP 协议工具集成自然语言处理开发效率
MCP サーバー/クライアント サンプル是一个用于学习和实现 Model Context Protocol (MCP) 的示例项目。它提供了一个最小化的 MCP 服务器实现,帮助开发者理解 MCP 的基本概念和工具集成方法。该项目的主要功能包括数値比较工具、服务器/客户端通信、以及通过 Google Gemini API 实现的自然语言处理接口。
View on GitHub
Overview
基本能力
产品定位
MCP サーバー/クライアント サンプル是一个教育和示例项目,旨在帮助开发者理解和实现 Model Context Protocol (MCP)。
核心功能
- MCP服务器功能
- 提供数値比较工具,用于比较两个数字的大小。
- 工具注册和执行管理。
- MCP客户端功能
- 与服务器的双向通信。
- 通过配置文件管理连接。
- 错误处理和重试机制。
- 聊天接口
- 使用 Google Gemini API 进行自然语言处理。
- 与 MCP 工具的集成功能。
适用场景
- MCP 协议的学习和实验。
- 开发独立的 MCP 服务器实现。
- 低成本验证 MCP 功能(利用 Google Gemini 的免费配额)。
工具列表
- 数値比较工具
- 功能:比较两个数字的大小,解决 AI 在比较问题上的常见错误。
常见问题解答
- 如何设置服务器路径? 服务器配置文件中的路径必须使用绝对路径。
- 如何管理环境变量?
环境变量应通过
.env
文件管理,并确保.gitignore
中包含该文件。 - 如何结束聊天会话?
输入
exit
、quit
或終了
可以结束聊天会话。
使用教程
使用依赖
- Bun 运行时 (v1.0.0 或更高版本)
bash # 安装 Bun curl -fsSL https://bun.sh/install | bash
- MCP 兼容客户端 (如 Claude Desktop App、Cline、Cursor)
- Gemini API 密钥 (用于聊天 CLI)
安装教程
- 项目设置 ```bash # 安装依赖 bun install
# 创建环境变量文件 cp .env.example .env
# 设置 Gemini API 密钥
echo 'GEMINI_API_KEY="your-api-key-here"' >> .env
2. **服务器配置**
创建 `server-config.json` 文件并配置服务器路径。
json
{
"my-simple-tool": {
"command": "bun",
"args": [
"run",
"/absolute/path/to/mcp-server/index.ts"
]
}
}
```
调试方式
- 启动聊天 CLI
bash bun run chat
- 测试工具功能 在聊天界面中输入需要比较的数字,观察工具的输出结果。
许可证
None