内容
# MCP Demo Server
运行
```
masteraccount@Mac Server % cd mcp-server-demo
masteraccount@Mac mcp-server-demo % export PYTHONPATH=$PWD/src
uv run mcp dev src/mcp_demo/server.py
```
一个模块化的模型上下文协议(Model Context Protocol,MCP)服务器,展示了构建MCP应用程序的最佳实践。
## 项目结构
```
mcp-demo/
├── src/
│ └── mcp_demo/ # 主包
│ ├── config/ # 配置设置
│ ├── resources/ # MCP资源
│ ├── tools/ # 按领域划分的MCP工具
│ ├── utils/ # 共享工具
│ ├── __init__.py # 包初始化
│ └── server.py # 主服务器入口点
├── pyproject.toml # 项目配置和依赖
└── README.md # 本文件
```
## 先决条件
- Python 3.11 或更高版本
- [uv](https://github.com/astral-sh/uv) 包管理器
## 安装
1. 克隆仓库:
```bash
git clone https://github.com/yourusername/mcp-demo.git
cd mcp-demo
```
2. 安装包及其依赖:
```bash
uv pip install .
```
## 运行服务器
您可以使用 `uv` 运行服务器:
```bash
uv run src/mcp_demo/server.py
```
## 开发
要以开发模式安装:
```bash
uv pip install -e .
```
## 特性
- 模块化架构,关注点分离清晰
- 类型安全的实现
- 全面的错误处理
- 安全优先的方法
- 易于扩展新工具和资源
## 文档
有关详细文档,请参阅:
- [添加工具](docs/guides/adding-tools.md)
- [添加资源](docs/guides/adding-resources.md)
- [配置管理](docs/guides/configuration.md)
## 许可证
MIT