JinDaGe - Model-Context-Protocol MCP Details

article

README

🚀 MCP 文件系统 API

本项目实现了一个 MCP（模型上下文协议）服务器，可通过 HTTP 请求与 文件系统 进行交互。它支持 文件创建、读取、复制、移动和删除 等操作，采用 FastAPI 实现。此外，还集成了 Google Gemini API 用于处理和总结文件内容。

✨ 主要特性

✅ 支持多种文件格式的读取 (.txt, .csv, .json, .xml, .docx)
✅ 高效流式处理大文件
✅ 集成 Google Gemini API 实现文本摘要功能
✅ 支持 Cloud Run 部署

🛠️ 技术栈

Python 3.9+
FastAPI
MCP（模型上下文协议）
Google Gemini API
Uvicorn（ASGI 服务器）
httpx（异步 HTTP 请求）
aiofiles（异步文件处理）
Docker & Cloud Run

📦 安装指南

1️⃣ 克隆仓库

$ git clone https://github.com/Vijayk-213/Model-Context-Protocol.git
$ cd Model-Context-Protocol

2️⃣ 创建虚拟环境

$ python3 -m venv venv
$ source venv/bin/activate  # 在 Windows 上使用 `venv\Scripts\activate`

3️⃣ 安装依赖项

$ pip install -r requirements.txt

4️⃣ 设置环境变量

创建一个 .env 文件并添加你的 Google Gemini API Key：

MCP_SERVER_URL=http://127.0.0.1:8000
GEMINI_API_KEY=your_gemini_api_key

🚀 快速开始

启动 MCP 服务器

$ uvicorn mcp_server:app --host 127.0.0.1 --port 8000 --reload

运行主应用

$ python main.py

📚 详细文档

📌 API 端点

| 方法 | 端点 | 描述 | |--------|----------------|---------------------------------| | GET | /read-text-from-file?file_path=path.txt | 读取文件内容 | | POST | /invoke | 调用 MCP 函数 |

🛠️ 未来增强

✅ 实现 WebSocket 以支持实时文件更新
✅ 添加对 云存储（Google Cloud Storage、AWS S3） 的支持
✅ 改进 错误处理和日志记录

📌 贡献

欢迎自由地打开问题或拉取请求来改进项目！

🚀 愉快的编码！ 🎯

Model-Context-Protocol