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

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

site icon
2025.03.26 0
TypeScriptMCP 协议工具集成自然语言处理开发效率
MCP サーバー/クライアント サンプル是一个用于学习和实现 Model Context Protocol (MCP) 的示例项目。它提供了一个最小化的 MCP 服务器实现,帮助开发者理解 MCP 的基本概念和工具集成方法。该项目的主要功能包括数値比较工具、服务器/客户端通信、以及通过 Google Gemini API 实现的自然语言处理接口。
View on GitHub

Overview

基本能力

产品定位

MCP サーバー/クライアント サンプル是一个教育和示例项目,旨在帮助开发者理解和实现 Model Context Protocol (MCP)。

核心功能

  1. MCP服务器功能
  2. 提供数値比较工具,用于比较两个数字的大小。
  3. 工具注册和执行管理。
  4. MCP客户端功能
  5. 与服务器的双向通信。
  6. 通过配置文件管理连接。
  7. 错误处理和重试机制。
  8. 聊天接口
  9. 使用 Google Gemini API 进行自然语言处理。
  10. 与 MCP 工具的集成功能。

适用场景

  • MCP 协议的学习和实验。
  • 开发独立的 MCP 服务器实现。
  • 低成本验证 MCP 功能(利用 Google Gemini 的免费配额)。

工具列表

  1. 数値比较工具
  2. 功能:比较两个数字的大小,解决 AI 在比较问题上的常见错误。

常见问题解答

  • 如何设置服务器路径? 服务器配置文件中的路径必须使用绝对路径。
  • 如何管理环境变量? 环境变量应通过 .env 文件管理,并确保 .gitignore 中包含该文件。
  • 如何结束聊天会话? 输入 exitquit終了 可以结束聊天会话。

使用教程

使用依赖

  1. Bun 运行时 (v1.0.0 或更高版本) bash # 安装 Bun curl -fsSL https://bun.sh/install | bash
  2. MCP 兼容客户端 (如 Claude Desktop App、Cline、Cursor)
  3. Gemini API 密钥 (用于聊天 CLI)

安装教程

  1. 项目设置 ```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" ] } } ```

调试方式

  1. 启动聊天 CLI bash bun run chat
  2. 测试工具功能 在聊天界面中输入需要比较的数字,观察工具的输出结果。

许可证

None