SQL代理工具

使用MCP构建AI SQL代理,通过自然语言与SQLite数据库交互。

  • by chicks2014
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 chicks2014/mcp-sql-server

使用说明

使用SQL代理介绍MCP

使用MCP构建一个AI SQL代理,通过以下方式与SQLite数据库交互 自然语言。

📺 观看教程

主要特点

  • 使用MCP创建AI SQL代理。
  • 使用自然语言与SQLite数据库交互。
  • 使用Claude 3 Sonnet生成SQL查询。
  • 安全地执行SQL查询。
  • 学习如何使用MCP构建AI工具。

技术栈

  • Anthropic
  • 洛古鲁
  • 主控程序
  • Python dotenv
  • 富有的
  • 数据库

入门指南

先决条件

  • Python 3.12+
  • 紫外线
  • Anthropic API密钥(设置于 .env 文件)

安装

  1. 克隆存储库。

  2. 导航到项目目录: cd mcp-sql-server

  3. 使用uv安装依赖项: uv sync

  4. 创建一个 .env 使用您的Anthropic API密钥文件:

    ANTHROPIC_API_KEY=sk-ant-api03-YOUR_API_KEY
    

用法

  1. 运行MCP客户端: uv run mcp_client.py
  2. 用自然语言输入SQL查询。

请注意,您不需要显式运行服务器,因为客户端会自动运行它。

项目结构

mcp-sql-server/
├── README.md         # Project documentation
├── mcp_client.py     # MCP client script
├── mcp_server.py     # MCP server script
├── database.db       # SQLite database
├── pyproject.toml    # Project dependencies
├── .env              # Environment variables
├── .gitignore        # Git ignore file
├── .python-version   # Python version
├── layout.zellij     # Zellij layout for development
├── code.zellij       # Zellij layout for code editing
└── demo.zellij       # Zellij layout for demo

实现细节

  • 这 mcp_server.py 文件定义了一个MCP服务器 query_data 工具到 执行SQL查询。
  • 这 mcp_client.py 该文件使用Anthropic Claude 3 Sonnet模型生成 来自自然语言输入的SQL查询。
  • 这 chinook.db file是用于演示的SQLite数据库。
  • Zellij布局用于开发和演示目的。

贡献

  1. 分叉存储库。
  2. 创建特征分支。
  3. 提交拉取请求。

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。