Skip to main content
Glama
deenesjakoruzh
pathennessy

socrata-mcp

by pathennessy
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

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 上搜索教育数据集"

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
F
license - not found
Not graded
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • Data.gov MCP Server

    melaodoidao
    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
    142
    19
    MIT

  • mcp-data-kcmo

    pipeworx-io
    A
    license
    Not graded
    quality
    C
    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.
    9
    MIT

  • mcp-data-montgomery

    pipeworx-io
    A
    license
    Not graded
    quality
    C
    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.
    11
    MIT

View all related MCP servers

Related MCP Connectors

  • Data Michigan

    Michigan Open Data (data.michigan.gov) Socrata MCP.

  • hithereiamaliff-mcp-datagovmy

    This MCP server provides seamless access to Malaysia's government open data, including datasets, w…

  • Data Mo

    Missouri Open Data (data.mo.gov) Socrata MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/pathennessy/socrata-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server