模型上下文协议

一个完整的对话式应用程序项目,支持本地LLM、向量数据库、多用户会话和插件系统。

  • by eversonpereira
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 eversonpereira/mcp

使用说明

🧠 MCP-模型上下文协议

完整的会话应用程序设计:

  • ✅ FastAPI + JWT
  • ✅ 通过Ollama获得法学硕士学位(前:Mistral)
  • ✅ 矢量内存上下文 (ChromaDB)
  • ✅ 支持多个用户和会话
  • ✅ 长历史自动摘要
  • ✅ 执行实际动作的插件系统

🚀 如何旋转

1. 克隆项目并创建环境

git clone <repo>
cd mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2.配置o.env

MODEL_NAME=mistral
VECTOR_DB_PATH=./chroma
DB_PATH=./mcp.db
CONTEXT_LIMIT=5
SUMMARY_TRIGGER=20

3. 启动 Ollama

ollama run mistral

4. 上传服务器

chmod +x start.sh
./start.sh

🛡️ 认证

  • POST /auth/register: 创建新用户

  • POST /auth/login: 返回 JWT 令牌

在请求 /mcp/chat 时使用 JWT 令牌。

🤖 插件

调用插件:

{
  "session_id": "sessao01",
  "prompt": "plugin: {\"name\": \"list_files\", \"args\": {\"path\": \"/etc\"}}"
}

📁 结构

app/
├── routes/         # Rotas da API
├── services/       # Lógica de negócio (MCP, plugins, memória)
├── db/             # Persistência (SQLite e vetorial)
├── models/         # Schemas Pydantic
├── plugins/        # Plugins executáveis pelo MCP
├── auth/           # Login, JWT, usuários

📬 联系方式

开发者:Everson🧠].