西雅图开放数据代理友好的MCP服务器：data.seattle.gov 数据集的搜索、描述和查询
概览
一个面向西雅图开放数据（Socrata SODA2）的代理友好MCP服务器。 这四个工具都与实时门户相抗衡，并有七个旗舰数据集的精选指南。请参见代理人评估的评估/结果。 服务器运行在 stdio 上。下面的 uvx 命令需要 uv。 从最新版本下载 seattle-open-data- .mcpb，并用 Claude Desktop 打开。 作为STDIO服务器运行UVX Seattle-Open-Data： 设置SOCRATA_APP_TOKEN使用Socrata应用令牌，例如claude mcp add seattle-open-data -e SOCRATA_APP_TOKEN=... -- uvx seattle-open-data。该捆绑包在Claude Desktop的设置中要求使用。被拒绝令牌会被报告为app_token_rejected，绝不会被静默丢弃。 要本地构建 MCPB 捆绑包（需要 mcpb CLI）：创建 mcpb。 在升级版本后标记 vX.Y.Z：发布流程会构建并烟雾测试轮子、sdist 和 .mcpb，维护者批准后发布到 PyPI，并将这三个版本都附加到 GitHub 版本。详见文档/发布。
概述（AI 翻译）
一个面向西雅图开放数据（Socrata SODA2）的代理友好MCP服务器。
状态：alpha （0.2.0）。 这四个工具均与实时门户相抵触，并有七个旗舰数据集的精选指南。请参见评估/结果以获取代理评估。
工具
| 工具 | 目的 |
|---|---|
seattle_data_search_datasets |
按主题查找数据集 |
seattle_data_describe_dataset |
列、行计数、时间覆盖、位置字段、几何列 |
seattle_data_query_dataset |
有界读取与聚合（SoQL子句或原始SoQL） |
seattle_data_get_reference |
能力总结、SoQL帮助、指南、错误目录 |
安装
服务器运行在stdio上。下面的uvx命令需要uv。
Claude Desktop： 从最新版本下载seattle-open-data- .mcpb，并用Claude Desktop打开。
克劳德代码：
法典：
**任何其他MCP客户端：**运行uvx seattle-open-data作为标准服务器：
可选应用令牌： 设置 SOCRATA_APP_TOKEN 使用 Socrata 应用令牌，例如 claude mcp add seattle-open-data -e SOCRATA_APP_TOKEN=... -- uvx seattle-open-data。该捆绑包在 Claude Desktop 的设置中要求使用。
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
seattle-open-data
An agent-friendly MCP server for Seattle Open Data (Socrata SODA2).
Status: alpha (0.2.0). All four tools work against the live portal, with curated guides for seven flagship datasets. See evals/results for the agent evaluation.
Tools
| Tool | Purpose |
|---|---|
seattle_data_search_datasets |
Find datasets by topic |
seattle_data_describe_dataset |
Columns, row count, time coverage, place fields, geo columns |
seattle_data_query_dataset |
Bounded reads and aggregates (SoQL clauses or raw SoQL) |
seattle_data_get_reference |
Capability summary, SoQL help, guides, error catalog |
Install
The server runs over stdio. The uvx commands below need uv.
Claude Desktop: download seattle-open-data-.mcpb from the latest release and open it with Claude Desktop.
Claude Code:
claude mcp add seattle-open-data -- uvx seattle-open-data
Codex:
codex mcp add seattle-open-data -- uvx seattle-open-data
Any other MCP client: run uvx seattle-open-data as a stdio server:
{
"mcpServers": {
"seattle-open-data": { "command": "uvx", "args": ["seattle-open-data"] }
}
}
Optional app token: set SOCRATA_APP_TOKEN to use a Socrata application token, for example claude mcp add seattle-open-data -e SOCRATA_APP_TOKEN=... -- uvx seattle-open-data. The bundle asks for it in Claude Desktop’s settings. A rejected token is reported as app_token_rejected, never silently dropped.
Develop
From a checkout:
uv sync
uv run seattle-open-data # run the server over stdio
uv run pytest
uv run ruff check && uv run ruff format --check && uv run ty check
UPDATE_SNAPSHOTS=1 uv run pytest tests/test_contract.py # after an intended tool-surface change
uv run pytest --run-integration -m integration # live tests against data.seattle.gov
uv run python evals/run.py [--host claude|codex] [task_id ...]
uv run python evals/report.py --answers
To build the MCPB bundle locally (needs the mcpb CLI): make mcpb.
Release
安装
uvx seattle-open-data配置
{
"mcpServers": {
"seattle-open-data": { "command": "uvx", "args": ["seattle-open-data"] }
}
}