MCP Sqlite Server

🚀 SQLite MCP 服務器

本項目是一個用 Python 編寫的 MCP（模型上下文協議）服務器，它能連接到包含初創公司融資數據的 SQLite 數據庫。服務器會公開表結構作為資源，提供只讀 SQL 查詢工具，還能提供常見數據分析任務的提示模板。該服務器可與 MCP 客戶端和大語言模型（LLMs）配合使用，通過 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：

<同上>

運行命令：

python create_db.py

創建虛擬環境

python -m venv venv

激活環境：

• macOS/Linux：

source venv/bin/activate

• Windows：

venv\Scripts\activate

安裝依賴項：

pip install "mcp[cli]"

運行 MCP 服務器

1. 將服務器代碼保存為 sqlite_mcp_server.py。
2. 運行服務器：

python sqlite_mcp_server.py

使用 uv 可選：

uv run sqlite_mcp_server.py

安裝到 Claude Desktop

將以下內容保存為 install_to_claude.py 並運行：

python install_to_claude.py

💻 使用示例

基礎用法

從 MCP 服務器獲取表結構

mcp server --host localhost:5000 --get schema://sqlite/sales

執行 SQL 查詢

mcp server --host localhost:5000 --query "SELECT * FROM sales LIMIT 5"

生成查詢描述

mcp server --host localhost:5000 --describe "SELECT COUNT(*) FROM customers WHERE state = 'CA'"

📚 詳細文檔

測試

使用 MCP CLI 工具測試服務器

1. 安裝 MCP CLI：

pip install mcp-cli

2. 測試表結構獲取：

mcp test --host localhost:5000 --test-get schema://sqlite/sales

3. 測試 SQL 查詢執行：

mcp test --host localhost:5000 --test-query "SELECT * FROM sales LIMIT 5"

日誌記錄

配置日誌文件

在 logging_config.json 中添加以下內容：

{
  "version": 1,
  "handlers": {
    "file_handler": {
      "class": "logging.FileHandler",
      "filename": "mcp_server.log",
      "level": "INFO"
    }
  },
  "root": {
    "level": "INFO",
    "handlers": ["file_handler"]
  }
}

啟用日誌記錄

在 sqlite_mcp_server.py 中添加以下內容：

import logging
from logging.config import fileConfig

fileConfig("logging_config.json")
logger = logging.getLogger()

def main():
    # ...
    logger.info("Starting MCP Server")
    # ...

if __name__ == "__main__":
    main()

📄 許可證

此項目受 MIT License 保護。