🚀 Hello - MCP协议项目

本项目提供了一个简单的模型控制协议实现，能帮助您了解MCP协议的工作原理，助力复杂AI系统的集成与开发。

🚀 快速开始

安装使用

1. 克隆项目仓库：

git clone https://github.com/yourusername/hello-mcp.git
cd hello-mcp

2. 创建虚拟环境并安装依赖：

python -m venv env
source env/bin/activate  # Mac/Linux或env\Scripts\activate.bat Windows
pip install -r requirements.txt

配置文件

编辑config.yaml配置文件，填写以下信息：

• API访问密钥：从DeepSeek获取的API密钥

启动服务

uvicorn server:app --reload

✨ 主要特性

MCP协议简介

• 标准化AI模型交互协议
• 统一的工具调用规范
• 简化复杂AI系统集成
• 支持多模型协作平台

项目特点

客户端功能

• 交互式命令行聊天界面
• 支持MCP工具注册与发现
• 集成DeepSeek API接口

服务端功能

• 提供基础MCP协议实现
• 支持自定义工具扩展
• 内置示例工具集合

💻 使用示例

基础用法

注册MCP工具：

from mcp.client import MCPClient

client = MCPClient()
client.register_tool('tool_name', 'http://localhost:8000')

📚 详细文档

调试技巧

1. 检查服务启动日志，确认API接口正常运行。
2. 使用curl命令测试API接口：

curl http://localhost:8000/docs

MCP协议问答

什么是MCP协议？

• 问题1：MCP解决了哪些问题？

  • 标准化AI模型交互协议
  • 统一工具调用规范
  • 简化复杂AI系统集成
  • 支持多模型协作

• 问题2：MCP的发展历程？

  • 2023年：由Anthropic提出
  • 2024年：开源实现开始流行
  • 2025年：成为事实标准
  • 现在：广泛应用于AI系统集成

MCP与函数调用的区别

项目常见问题

配置问题

1. DeepSeek API配置错误？

   • 检查config.yaml中api_key是否正确填写

2. API密钥格式错误？

   • 确保没有多余的空格或引号
   • 可尝试重新生成API密钥

服务启动问题

1. 端口被占用？

lsof -i :8000    # 查看占用进程
kill -9 PID       # 杀死进程后重启服务

2. 修改默认端口？ 修改server.py中的app = FastAPI(...)配置

项目扩展开发

添加新工具

@app.post("/tool/{tool_name}")
async def handle_tool(tool_name: str, request_data: dict):
    # 实现自定义逻辑

📄 贡献指南

1. Fork本仓库
2. 创建功能分支
3. 提交代码
4. 创建Pull Request

欢迎通过Issues或Pull Request参与项目开发！