Skip to main content
Glama

Socrata MCP 服务器

License: MIT Generated with Claude

一个 MCP 服务器,为 Claude 提供探索和查询任何 Socrata 开放数据门户的工具。

工具

工具

描述

search_datasets

按关键字搜索数据集,可选择限定在特定的门户域名下

get_dataset_metadata

获取数据集的列定义和元数据

query_dataset

使用 SoQL WHERE / SELECT / ORDER 查询行

aggregate_dataset

使用 count/sum/avg 等进行 GROUP BY 聚合

list_portal_categories

列出特定门户上的数据集类别


Related MCP server: mcp-data-kcmo

安装

先决条件

你需要 Python 3.10 或更高版本。检查你的版本:

python3 --version

如果你需要安装或升级 Python:

  • macOS: brew install python (需要 Homebrew)

  • Ubuntu/Debian / WSL: sudo apt update && sudo apt install -y python3 python3-venv python3-pip

  • Fedora/RHEL: sudo dnf install python3

  • Windows 11 原生: 从 python.org 下载并在安装时勾选 Add to PATH


1. 克隆或复制此文件夹

git clone https://github.com/your-username/socrata-mcp.git
cd socrata-mcp

或者只需将 server.py 和 requirements.txt 文件复制到你选择的文件夹中。


2. 创建虚拟环境

python3 -m venv .venv

3. 激活虚拟环境

平台

命令

macOS / Linux / WSL

source .venv/bin/activate

Windows (cmd.exe)

.venv\Scripts\activate.bat

Windows (PowerShell)

.venv\Scripts\Activate.ps1

激活后,你的提示符将变为显示 (.venv)。


4. 安装依赖

pip install -r requirements.txt

5. 验证安装

python3 server.py --help

你应该会看到类似以下的错误:

RuntimeError: SOCRATA_DOMAIN environment variable is required

这意味着服务器已正确加载——它只需要配置你的凭据(见下文)。


配置

两个环境变量都是必需的。没有它们,服务器将无法启动。

变量

描述

示例

SOCRATA_DOMAIN

Socrata 门户的主机名

data.delaware.gov

SOCRATA_APP_TOKEN

来自你 Socrata 账户的 API 令牌

abc123xyz...

获取 API 令牌:登录你的 Socrata 门户 → Developer Settings(开发者设置) → Create New App Token(创建新应用令牌)。


添加到 Claude Desktop

Claude Desktop 从 JSON 配置文件中读取其 MCP 服务器列表。编辑适合你平台的配置文件:

平台

配置文件位置

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows 11

%APPDATA%\Claude\claude_desktop_config.json

WSL

使用上面的 Windows 路径 — Claude Desktop 在 Windows 上运行,而不是在 WSL 内部

macOS / Linux (原生)

{
  "mcpServers": {
    "socrata": {
      "command": "/absolute/path/to/socrata-mcp/.venv/bin/python3",
      "args": ["/absolute/path/to/socrata-mcp/server.py"],
      "env": {
        "SOCRATA_DOMAIN": "data.delaware.gov",
        "SOCRATA_APP_TOKEN": "your-api-key-here"
      }
    }
  }
}

将 /absolute/path/to/socrata-mcp 替换为实际路径。通过在项目文件夹内运行 pwd 来查找它。

Windows 11 (原生 Python)

{
  "mcpServers": {
    "socrata": {
      "command": "C:\\Users\\YourName\\socrata-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\Users\\YourName\\socrata-mcp\\server.py"],
      "env": {
        "SOCRATA_DOMAIN": "data.delaware.gov",
        "SOCRATA_APP_TOKEN": "your-api-key-here"
      }
    }
  }
}

Windows 11 使用 WSL

Claude Desktop 在 Windows 上运行,但可以通过 wsl.exe 启动 WSL 进程:

{
  "mcpServers": {
    "socrata": {
      "command": "wsl.exe",
      "args": [
        "--exec",
        "/home/your-wsl-username/socrata-mcp/.venv/bin/python3",
        "/home/your-wsl-username/socrata-mcp/server.py"
      ],
      "env": {
        "SOCRATA_DOMAIN": "data.delaware.gov",
        "SOCRATA_APP_TOKEN": "your-api-key-here"
      }
    }
  }
}

将 your-wsl-username 替换为你的 WSL 用户名(在 WSL 内部运行 whoami 以检查)。


编辑配置后,重启 Claude Desktop,你应该就能看到可用的 Socrata 工具了。


许可证

本项目采用 MIT 许可证 开源。

此代码由 Anthropic 的 Claude 生成。


查询示例

  • "特拉华州开放数据门户上有哪些数据集?"

  • "向我展示 2025 财年按合同支出排名的前几名供应商"

  • "数据集 sifm-293u 中有哪些列?"

  • "去年哪些机构在云解决方案上花费最多?"

  • "在 data.delaware.gov 上搜索教育数据集"

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that provides access to government datasets from Data.gov, enabling users to search packages, view dataset details, list groups and tags, and access resources by URL.
      4
      76 npm
      20
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for accessing Kansas City, MO open data through the Socrata SODA API. Enables querying and retrieving public datasets from data.kcmo.org.
      99 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server providing access to Montgomery County, MD open data through the Socrata SODA API, enabling querying and analysis of public datasets via natural language.
      97 npm
      MIT