返回 MCP 目录
public公开dns本地运行

simple-mcp-mcp-project

一个完整的MCP项目,包含客户端和服务器组件,使用标准输入输出传输,支持交互式和单次查询模式,具备健壮的通信和详细日志功能。

article

README

🚀 MCP 项目 - 简单的 MCP 实现

本项目是一个完整的 MCP(管理控制协议)项目,涵盖客户端和服务器组件,采用标准 I/O 进行数据传输,为管理控制提供了可靠的解决方案。

✨ 主要特性

  • 可靠的通信:借助具备错误处理和超时管理的标准 I/O 传输机制,确保通信稳定可靠。
  • 多种连接方式:既可以连接到已在运行的服务器,也能启动新的服务器进程,使用灵活。
  • 交互模式:用户可选择工具并提供参数,实现交互式操作,增强使用体验。
  • 一次性模式:支持直接从命令行运行查询,方便快捷。
  • 全面日志记录:详细的日志有助于调试和监控,便于问题排查和系统维护。

📦 安装指南

构建服务器

cd server
cargo build

构建客户端

cd ../client
cargo build

💻 使用示例

启动服务器

cd server
cargo run

运行客户端

cd client
cargo run -- --name "Your Name"

交互模式

cd client
cargo run -- --interactive

测试方法

./test.sh

📚 详细文档

项目结构

  • client/:存放 MCP 客户端的实现代码。
  • server/:包含 MCP 服务器的实现及工具代码。
  • test.sh:这是一个测试脚本,用于运行客户端和服务器,方便进行项目测试。

可用工具

  • hello:这是一个简单的打招呼工具,能够根据用户输入的名字进行问候。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端