Sqlite Anet MCP

🚀 SQLite-Anet-MCP 服务器

本项目是基于 Model Control Protocol (MCP) 的 Rust 实现，它借助标准化协议为用户提供访问 SQLite 数据库的功能。通过该服务器，AI 代理能够直接对 SQLite 数据库进行创建、管理和查询等操作。

该项目参考了 Model Context Protocol SQLite Server 的实现。

🚀 快速开始

配置要求

• Rust 需 1.70 及以上版本。
• 需要运行中的 NATS 服务器（可本地运行或通过网络访问）。
• SQLite 作为 Rust 依赖项包含在内。

安装

克隆仓库并构建服务器：

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

在环境中配置变量，创建一个 .env 文件：

NATS_SERVER=nats://localhost:4222
SQLITE_DB=path/to/your/database.db

启动

运行服务器：

cargo run --release

访问工具接口：http://localhost:8080

测试

1. 启动 NATS 服务器。
2. 运行测试脚本：

cargo test

3. 使用示例请求进行交互。

✨ 主要特性

• 🗃️ 可创建和管理 SQLite 数据表。
• 🔍 能执行 SELECT 查询以检索数据。
• ✏️ 可执行 INSERT、UPDATE 和 DELETE 查询以操作数据。
• 📊 能描述表结构并列出可用表。
• 📝 可保存和综合业务洞察。
• 🔄 采用 NATS 传输层进行消息传递。
• 🛠️ 兼容 JSON-RPC 2.0 API。
• ⚡ 使用 Tokio 实现异步请求处理。

📦 安装指南

克隆仓库

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

配置环境变量

创建一个 .env 文件：

NATS_SERVER=nats://localhost:4222
SQLITE_DB=path/to/your/database.db

💻 使用示例

示例请求

{
  "method": "query_data",
  "params": {
    "table": "users",
    "columns": ["id", "name", "email"],
    "conditions": []
  }
}

响应示例

{
  "status": "success",
  "data": [
    { "id": 1, "name": "Alice", "email": "alice@example.com" },
    { "id": 2, "name": "Bob", "email": "bob@example.com" }
  ]
}

📚 详细文档

可用工具

数据库操作工具

• create_table：创建新表。
• query_data：执行自定义查询。
• insert_data：插入数据记录。
• update_record：更新指定记录。
• delete_record：删除指定记录。

业务洞察资源

• business_insights：生成和管理业务洞察报告。

开发指南

添加新功能

若要扩展服务器的功能，可按以下步骤操作：

1. 在 src/models/sqlite.rs 中定义响应结构。
2. 在 src/tools/ 文件夹中实现工具，遵循 Tool 特性。
3. 在 src/main.rs 中注册新工具。

故障排除

• 确保 NATS 服务器正在运行且可访问。
• 检查 SQLite 数据库路径是否正确设置。
• 验证请求格式与每个工具的输入模式匹配。

📄 许可证

本项目采用 MIT License。

致谢

该项目基于 Anet MCP Server 框架，并参考了 Model Context Protocol SQLite Server 的实现。