MeCP-模型上下文协议服务器
Rust中的生产就绪模型上下文协议服务器
具有多数据库支持、Web3身份验证和实时监控的自托管AI上下文管理
______________________________________________________________________
🚀 特性
核心能力
- 🦀 高性能防锈剂 -快速、内存安全的实施
- 📋 JSON-RPC 2.0 API -符合标准MCP协议
- 🔌 模块化架构 -可扩展的资源、工具和提示系统
- 📡 HTTP服务器 -支持CORS的RESTful API
数据库集成
- 🗄️ MySQL -具有连接池的关系数据存储
- 🕸️ Neo4j -用于复杂关系的图形数据库
- 🔢 米尔维斯 -用于嵌入的高性能矢量数据库
- 🔄 统一抽象层 -无缝切换数据库
监控和安全
- 📊 实时仪表盘 -用于指标和日志的漂亮web UI
- 💾 持续指标 -MySQL支持的分析和历史
- 🔐 Web3身份验证 -无气EVM钱包签名认证
- 🔒 JWT会议 -安全、无状态的会话管理
开发者体验
- ⚡ CLI管理 -一个命令数据库设置和控制
- 🧪 综合测试 -单元和集成测试套件
- 📚 完整的文件 -每个组件的指南
- 🐳 生产就绪 -通过企业功能进行实战测试
______________________________________________________________________
🎯 快速开始
先决条件
安装
# Clone the repository
git clone https://github.com/yourusername/mecp.git
cd mecp
# Build the project
cargo build --release
# Initialize databases
./scripts/init-mysql-db.sh
# Start the server
cargo run --release访问仪表板
http://127.0.0.1:3000/dashboard进行第一次API调用
curl -X POST http://127.0.0.1:3000/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "resources/list"
}'______________________________________________________________________
📚 文档
入门指南
特性
高级
______________________________________________________________________
🏗️ 建筑
┌─────────────────────────────────────────────────────────────┐
│ MeCP Server │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Resources │ │ Tools │ │ Prompts │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
│ ┌────────────────────────────────────────────────────┐ │
│ │ HTTP Server (Axum + Tower) │ │
│ │ ┌──────────┐ ┌──────────┐ ┌────────────────┐ │ │
│ │ │ /mcp │ │ /api/* │ │ /dashboard │ │ │
│ │ └──────────┘ └──────────┘ └────────────────┘ │ │
│ └────────────────────────────────────────────────────┘ │
│ │
│ ┌────────────────────────────────────────────────────┐ │
│ │ Database Abstraction Layer │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │ │
│ │ │ MySQL │ │ Neo4j │ │ Milvus │ │ │
│ │ └──────────┘ └──────────┘ └──────────────────┘ │ │
│ └────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘关键组件
- 核心服务器 -具有可扩展处理程序的MCP协议实现
- HTTP层 -基于Axum的web服务器,支持中间件
- 数据库层 -SQL、Graph和Vector DB的基于特征的抽象
- 度量系统 -MySQL持久化实时收集
- 身份验证模块 -EVM签名验证和JWT令牌管理
______________________________________________________________________
🛠️ 技术栈
| 组件 | 技术 |
|---|---|
| 语言 | Rust 2021版 |
| Web框架 | Axum 0.7 |
| 数据库 | MySQL 8.0、Neo4j、Milvus |
| 身份验证 | 以太坊、jsonwebtoken |
| 序列化 | serde,serde_json |
| 异步运行时 | 东京 |
| 测试 | tokio测试,reqwest |
______________________________________________________________________
📊 仪表盘
集成监控仪表板提供:
- 📈 实时度量 -API呼叫率、成功率、响应时间
- 📝 请求历史 -包含完整请求/响应数据的详细日志
- 🐛 错误跟踪 -使用堆栈跟踪进行专用错误监控
- 📊 分析 -每个端点的统计数据和趋势
- 🔄 实时更新 -每5秒自动刷新一次
- 🔐 安全访问 -可选Web3钱包身份验证
______________________________________________________________________
🔐 Web3身份验证
使用加密钱包签名保护您的仪表板:
# Quick setup
./scripts/setup-auth-example.sh
# Or manual configuration
[auth]
enabled = true
allowed_address = "0xYourWalletAddress"
jwt_secret = "your-secret-key"
session_duration = 86400特征:
- ✅ 无气体身份验证 -无区块链交易
- ✅ EVM兼容 -适用于MetaMask、WalletConnect等。
- ✅ 24小时会议 -基于JWT的会话管理
- ✅ 生产就绪 -用于实时部署
______________________________________________________________________
🧪 测试
# Run all tests
cargo test
# Run integration tests
cargo test --test integration_test
# Run with coverage
cargo tarpaulin --out Html
# Test dashboard flow
./scripts/test-dashboard-flow.sh______________________________________________________________________
🚀 部署
生产检查表
- \[\]配置强JWT密钥(
openssl rand -hex 64) - \[\]使用反向代理(nginx/caddy)设置HTTPS
- \[\]在身份验证端点上启用速率限制
- \[\]配置数据库连接池
- \[\]设置监控和警报
- \[\]定期备份数据库
- \[\]查看中的安全设置
config.toml
Docker部署(即将推出)
docker-compose up -d______________________________________________________________________
🤝 贡献
我们欢迎捐款!请查看我们的 贡献指南 了解详情。
开发设置
# Clone and setup
git clone https://github.com/yourusername/mecp.git
cd mecp
cargo build
# Run tests
cargo test
# Check formatting
cargo fmt --check
# Run linter
cargo clippy贡献领域
- 🐛 Bug修复和改进
- ✨ 新的数据库适配器(PostgreSQL、MongoDB等)
- 📚 文档增强
- 🧪 附加测试覆盖率
- 🎨 仪表板UI改进
- 🔌 新的MCP工具和资源
______________________________________________________________________
📜 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
______________________________________________________________________
🙏 致谢
- 模型上下文协议 规格
- 优秀库的Rust社区
- 贡献者和支持者
______________________________________________________________________
📞 支持
- 问题:
- 讨论:
- 文档: 全部文件
______________________________________________________________________
建于❤️ 在Rust
⭐ 在GitHub上为我们投票🐛 报告问题|🤝 贡献
