Analyst MCP Server Example

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

工具摘要

安装和设置（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/

1. 可选但推荐：使用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服务器运行可能需要几分钟。

1. 得到 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.