MCP服务器演示

本项目演示了模型上下文协议 (MCP) 服务器的实现。 MCP 是一种旨在促进 AI 模型与外部工具/服务之间通信，同时保持上下文感知的协议。

特性

• 基本的 MCP 服务器实现
• 示例工具集成
• 上下文管理演示
• 基于 WebSocket 的实时通信
• 简单的客户端示例

项目结构

mcp-server-demo/
├── src/
│   ├── server.py           # 主要的 MCP 服务器实现
│   ├── tools/              # 工具实现
│   │   ├── __init__.py
│   │   └── basic_tools.py
│   ├── context/            # 上下文管理
│   │   ├── __init__.py
│   │   └── manager.py
│   └── utils/             # 实用函数
│       ├── __init__.py
│       └── helpers.py
├── examples/              # 示例用法
│   ├── client.py
│   └── tools_demo.py
├── tests/                # 测试用例
│   └── test_server.py
├── requirements.txt      # 项目依赖
└── README.md            # 本文件

安装

1. 克隆仓库：

git clone https://github.com/tian1ll1/mcp-server-demo.git
cd mcp-server-demo

2. 创建一个虚拟环境（推荐）：

python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

3. 安装依赖：

pip install -r requirements.txt

用法

1. 启动 MCP 服务器：

python src/server.py

2. 运行示例客户端：

python examples/client.py

工作原理

MCP 服务器实现了以下关键组件：

1. 上下文管理：维护每个会话的对话历史记录和相关上下文。
2. 工具注册表：管理可用的工具及其规范。
3. 消息处理：处理传入的消息并将它们路由到适当的工具。
4. WebSocket 服务器：提供与客户端的实时通信。

贡献

欢迎贡献！ 请随时提交 Pull Request。

许可证

本项目采用 MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。