MCP服务器示例
](https://www.python.org/downloads/) 
Python中MCP（模型上下文协议）服务器示例集合，帮助您开始构建自己的MCP服务器。
📖 关于
模型上下文协议（MCP）是一种开放协议，用于规范应用程序与AI助手之间的通信。此存储库包含MCP服务器的实际示例，以帮助您理解和创建自己的实现。
🚀 快速启动
安装
- 克隆仓库
git clone https://github.com/ChuckZombie/serveurs-mcp-exemple.git
cd serveurs-mcp-exemple- 创建虚拟环境
# Windows
python -m venv venv
.\venv\Scripts\Activate.ps1
# Linux/macOS
python -m venv venv
source venv/bin/activate- 安装依赖项
pip install -r requirements.txt使用您的MCP客户端进行配置
MCP服务器可以与任何兼容MCP的客户端（如Claude Desktop、GitHub Copilot、Continue、Cline等）一起使用。
通用配置示例
在您的MCP客户端配置文件中添加服务器配置（请根据实际情况调整路径）：
{
"mcpServers": {
"math-operations": {
"command": "/chemin/absolu/vers/venv/bin/python",
"args": ["/chemin/absolu/vers/src/math-operations/server.py"]
},
"read-file": {
"command": "/chemin/absolu/vers/venv/bin/python",
"args": ["/chemin/absolu/vers/src/read-file/server.py"]
}
}
}针对客户的特定配置
GitHub Copilot
通过VS Code的设置进行配置 mcp.json 或者通过设置界面。
Claude Desktop
配置文件：
- Windows ：
%APPDATA%\Claude\claude_desktop_config.json - macOS（发音为 /ˈmækˌɒs/，中文常简称为“苹果电脑系统”或直接使用英文原名） ：
~/Library/Application Support/Claude/claude_desktop_config.json - Linux ：
~/.config/Claude/claude_desktop_config.json
修改后，请重新启动Claude Desktop。
Continue
在文件中添加配置 config.json 在Continue（一种持续运行或继续的状态），通常位于 .continue/config.json 关于您的项目。
Cline
通过VS Code在Cline设置中配置MCP服务器。
Autres clients MCP
请查阅您的MCP客户端文档，以了解配置文件的位置和所需格式。
📚 可用服务器
1. 🧮 数学运算
用于执行基本数学运算的服务器。
可用工具：
- 加法，减法，乘法，除法
- 幂，平方根
- 模，绝对值
📖 书籍 完整文档
2. 📄 读取文件
用于读取文本文件内容的服务器。
特点：
- 读取UTF-8文件
- 处理大文件（限制5MB）
- 强大的错误处理能力
📖 书籍 完整文档
🛠️ 项目结构
serveurs-mcp-exemple/
├── src/
│ ├── math-operations/ # Serveur opérations mathématiques
│ │ ├── server.py
│ │ ├── mcp.json
│ │ └── README.md
│ └── read-file/ # Serveur lecture de fichiers
│ ├── server.py
│ ├── mcp.json
│ ├── README.md
│ └── exemple_fichier.txt
├── requirements.txt # Dépendances Python
├── .gitignore
├── CONTRIBUTING.md # Guide de contribution
├── CHANGELOG.md # Historique des versions
└── README.md💡 使用示例
在您的MCP客户端中配置后，您可以直接使用这些服务器：
Vous: "Calcule 15 + 27"
Assistant IA: [Utilise l'outil addition] Le résultat est 42
Vous: "Quelle est la racine carrée de 144 ?"
Assistant IA: [Utilise l'outil racine_carree] La racine carrée de 144 est 12
Vous: "Lis le fichier exemple_fichier.txt"
Assistant IA: [Utilise l'outil read_file] Voici le contenu du fichier...🔧 可用工具的详细信息
🧮 Math Operations - 8 outils
1. 添加
把两个数相加。
- 参数：
a（名字），b（名字） - 示例：
a=5, b=3→ 结果：8
2. 减法
用第一个数减去第二个数。
- 参数：
a（名字），b（名字） - 示例：
a=10, b=4→ 结果：6
3. 乘法
将两个数相乘。
- 参数：
a（名字），b（姓名） - 示例：
a=6, b=7→ 结果：42
4. 除法（或“除”）
用第一个数除以第二个数。
- 参数：
a（分子），b（分母，不能为0） - 示例：
a=15, b=3→ 结果：5
5. 力量
计算a的b次方。
- 参数：
a（基地），b（参展商） - 示例：
a=2, b=8→ 结果：256
6. 平方根
计算一个数的平方根。
- 参数：
a（名称，必须为正数） - 示例：
a=25→ 结果：5
7. 模块
计算a除以b的余数。
- 参数：
a（股息），b（除数，不能为0） - 示例：
a=17, b=5→ 结果：2
8. 绝对值
计算一个数的绝对值。
- 参数：
a（姓名） - 示例：
a=-42→ 结果：42
📄 Read File - 1 outil
读取文件
读取文本文件的内容。
- 参数：
file_path（文件路径） - 限制：最大5MB
- 编码：UTF-8
- 示例：
file_path="exemple_fichier.txt"→ 文件内容
错误处理：
- 文件不存在
- 文件过大（> 5 MB）- 内容已截断
- UTF-8编码错误
- 通用读取错误
🤝 贡献
为这样一个示范项目做贡献真的合理吗？ 🤔
好吧，如果您真的坚持的话，那就请查阅 \CONTRIBUTING.md\ 翻译为中文是：“贡献指南/贡献说明文件”。这个文件通常用于说明如何为某个项目或组织做出贡献，包括提交代码、报告问题、提出建议等相关的指南和规范 首先。
新服务器的想法
- \[ \] 单位转换服务器
- \[ \] 日期处理服务器
- \[ \] CSV数据分析服务器
- \[ \] 数据库交互服务器
- \[ \] 图形生成服务器
- \[ \] REST API服务器
请随时通过 Issues 提出您的想法！
📋 前提条件
- Python 3.12或更高版本
- 一个兼容MCP的客户端（如Claude Desktop、GitHub Copilot、Continue、Cline等）
📖 资源
📄 许可证
这个项目是开源的……啊不，不是开源！:-p
这些只是学习的例子，你们想怎么做就怎么做！
🙏 感谢
- Anthropic致力于开发上下文模型协议
- MCP社区提供资源和支持
- 致Desybes团队，感谢你们的天才创意，并允许我在测试文件中使用你们的名称
______________________________________________________________________
⭐ 如果这个项目对您有帮助，请不要吝啬给它一颗星！