AI导哈

数据查询分析服务器

Socrata MCP Server是一个模型上下文协议服务器，使AI代理能够使用自然语言查询Socrata开放数据平台并从数据中生成见解。

  • by Thomas-TyTech
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Thomas-TyTech/Socrata-MCP

使用说明

Socrata MCP 服务器

一个模型上下文协议（MCP）服务器，它使人工智能代理能够使用自然语言查询Socrata开放数据平台，并从数据中生成见解。

特点/特性

  • 查询数据集在Socrata数据集上执行SoQL查询，支持JSON、CSV和GeoJSON格式
  • 搜索数据集在Socrata域名中通过关键词查找数据集
  • 数据集信息获取数据集的元数据和架构信息
  • 自然语言查询将自然语言问题转换为SoQL查询（基础实现）
  • 数据分析生成包括摘要、趋势、相关性以及异常检测在内的见解

安装

# Clone the repository
git clone <repository-url>
cd socrata-mcp

# Install dependencies
pip install -e .

# Test the installation
python examples/test_functionality.py

与MCP客户端的使用

这是一个 MCP（模型上下文协议）服务器 这需要与MCP兼容的客户端一起使用。它不能单独使用——您必须将其与支持MCP的客户端一起配置。有很多这样的客户端，我在下面列出了一些。

支持的MCP客户端

不同客户端的配置

Cline（VS Code 扩展）

  1. 在VS Code中安装Cline扩展
  2. 打开Cline设置并添加此MCP服务器配置：
{
  "mcpServers": {
    "socrata": {
      "command": "python3",
      "args": ["-m", "socrata_mcp.server"],
      "cwd": "/path/to/your/socrata-mcp",
      "env": {
        "SOCRATA_APP_TOKEN": "your_app_token_here_optional"
      }
    }
  }
}

Claude Desktop（可译为“Claude桌面版”或根据具体语境简化为“Claude桌面”）

  1. 下载并安装Claude桌面版
  2. 打开Claude桌面设置（通常 ~/Library/Application Support/Claude/claude_desktop_config.json （在 macOS 上）
  3. 添加此配置：
{
  "mcpServers": {
    "socrata": {
      "command": "python3",
      "args": ["-m", "socrata_mcp.server"],
      "cwd": "/path/to/your/socrata-mcp",
      "env": {
        "SOCRATA_APP_TOKEN": "your_app_token_here"
      }
    }
  }
}

克劳德代码（TUI CLI 工具）

  1. 按照说明安装Claude Code 安装指南
  2. 使用（指定方法/工具）添加MCP服务器 claude mcp add 命令：
    # Basic syntax
claude mcp add <name> <command> [args...]

# Add Socrata MCP server
claude mcp add socrata --env SOCRATA_APP_TOKEN=your_token_here \
  -- python3 -m socrata_mcp.server
    或者在您的Claude代码设置中手动进行配置，按照以下步骤 MCP配置指南

配置说明

可用工具

一旦配置了MCP客户端，您将可以使用以下工具：

  1. 查询数据集在Socrata数据集上执行SoQL查询
  2. 搜索数据集跨领域按关键词搜索数据集
  3. 获取数据集信息获取详细的元数据和架构信息
  4. 自然语言查询将自然语言问题转换为SoQL查询
  5. 分析数据从查询结果中生成统计见解

示例用法

在使用MCP客户端进行配置后，您可以提出诸如以下问题：

  • “查找芝加哥的犯罪数据集”
  • “西雅图最常见的犯罪类型是什么？”
  • 去年在旧金山颁发的建筑许可证给我看一下
  • “分析纽约的交通事故趋势”

您连接到MCP服务器的AI助手将使用Socrata MCP来搜索相关数据集、查询数据并提供见解。

相关 MCP