AI导哈

数据查询分析服务器

一个应用于合成超市数据库的数据查询和分析的MCP服务器，支持SQL查询、缓存操作、Python代码执行和语义搜索等功能。

  • by Alieladi
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Alieladi/analyst-MCP-server-example

使用说明

这是一个应用于综合超市数据库的用于数据查询和分析的MCP服务器的示例。 结账https://medium.com/@alieladi/core-components-one-data-query-analysis-mcp-server-ec2cd6cde34d获取更多信息！

工具摘要

工具 目的
sql_query(sql, params) 执行智能SELECT查询
cache_get_rows(cache_key) 浏览缓存结果
run_python_on_cache(cache_key, code) 在缓存数据上运行Python代码（例如Pandas）
get_schema() 返回架构资源
search_products_catalog(query) 语义+词汇混合搜索

安装和设置（uv）

超市MCP服务器位于 supermarket/mcp_server 并使用uv进行依赖管理。

需求

  • 已安装紫外线（参见https://docs.astral.sh/uv/getting-started/)
  • Python 3.13（uv可以自动安装）

步骤

  1. 安装uv（如果您还没有）——请参阅https://docs.astral.sh/uv/getting-started/

  2. 可选但推荐：使用uv安装依赖项：

    • 从repo根目录（此文件夹）：
      • 在不激活venv的情况下同步服务器env：
        • uv sync --directory mcp_server
      • 或者显式创建并激活一个venv：
        • uv venv --python 3.13
        • source .venv/bin/activate
        • cd mcp_server && uv sync 注意：如果不执行此步骤，如果uv需要安装Python或大型依赖项，则第一次mcp服务器运行可能需要几分钟。

  3. 得到 VOYAGE_API_KEY --中的语义搜索所需 search_products_catalog-从https://www.voyageai.com/

与克劳德桌面（MCP）一起使用

将此添加到您的Claude桌面 mcpServers 配置。更新绝对路径以匹配您的计算机。

{
    "mcpServers": {
        "supermarket": {
            "command": "uv", 
            "args": [
                "--directory",
                "/absolute/path/to/your/checkout/supermarket/mcp_server",
                "run",
                "main.py"
            ],
            "env": {
                "VOYAGE_API_KEY": "YOUR_VOYAGE_API_KEY"
            }
        }
    }
}

备注

  • 如果 uv 不在PATH中，请使用其完整路径。
  • VOYAGE_API_KEY 在中进行语义搜索时需要 search_products_catalog.

相关 MCP