MCP 服务器

SQLite MCP Server

这些是 MCP 服务器的实现，用于在您的 MCP 客户端中访问 SQLite 数据库。其中包括 SDIO 和 SSE 两种实现方式。

prayanks

开发者工具

README

SQLite MCP 服务器

本仓库包含一个用 Python 编写的 MCP (模型上下文协议) 服务器，该服务器连接到一个包含初创公司融资数据的 SQLite 数据库。该服务器将表模式作为资源公开，提供只读 SQL 查询工具，并为常见的数据分析任务提供提示模板。它旨在与 MCP 客户端和语言模型 (LLM) 一起使用，并通过 STDIO 协议进行通信。

概述

MCP 服务器使用 MCP Python SDK (带有 CLI 扩展) 来实现一个服务器，该服务器：

连接到 SQLite 数据库 (例如，包含初创公司融资信息的数据库)。
将表模式作为 MCP 资源公开。
提供用于执行只读 SQL 查询的工具。
提供提示模板，帮助语言模型生成数据分析见解。
通过 STDIO 协议进行通信，从标准输入读取 JSON-RPC 消息，并将响应写入标准输出。

特性

资源
- schema://sqlite/{table}: 返回特定表的 SQL 模式。
- schema://sqlite/all: 返回所有表模式的 JSON 映射。
工具
- sql_query: 执行只读 SQL 查询。只允许 SELECT 语句。
提示
- analyze_table_prompt: 为特定表生成分析提示。
- describe_query_prompt: 生成解释 SQL 查询的提示。
STDIO 协议
- 从 stdin 读取并将响应写入 stdout，从而简化集成。
日志记录
- 使用 Python 的 logging 模块来跟踪活动和调试错误。

设置和安装

创建示例 SQLite 数据库

将以下脚本另存为 create_db.py：

<same as earlier>

运行：

python create_db.py

创建虚拟环境

python -m venv venv

激活环境：

macOS/Linux:
```
source venv/bin/activate
```
Windows:
```
venv\Scripts\activate
```

安装依赖项：

pip install "mcp[cli]"

运行 MCP 服务器

将服务器代码另存为 sqlite_mcp_server.py。
运行服务器：

python sqlite_mcp_server.py

可选 (使用 uv):

uv run sqlite_mcp_server.py

安装到 Claude Desktop

将以下内容另存为 install_to_claude.py 并运行它：

python install_to_claude.py

使用以下内容更新 Claude Desktop 配置：

{
  "mcpServers": {
    "sqlite_mcp_server": {
      "command": "python",
      "args": ["-u", "/absolute/path/to/sqlite_mcp_server.py"]
    }
  }
}

之后重启 Claude Desktop。

用法

访问资源: schema://sqlite/all, schema://sqlite/startups

调用工具:

SELECT * FROM startups WHERE funding_amount > 10000000;

使用提示: 生成 SQL 或解释查询。

测试

运行测试脚本：

python sqlite_mcp_client_tests.py sqlite_mcp_server.py

此脚本测试：

列出资源
检索模式
有效/无效查询
提示模板

日志记录

修改日志记录配置：

logging.basicConfig(
    filename='mcp_server.log',
    level=logging.DEBUG,
    format="[%(asctime)s] %(levelname)s - %(message)s",
    datefmt="%Y-%m-%d %H:%M:%S"
)

默认情况下，日志打印到 stderr。