Skillget

civic-ai-tools

mcp
Guvenlik Denetimi
Uyari
Health Uyari
  • No license — Repository has no license file
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 23 GitHub stars
Code Gecti
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This platform connects AI assistants to government open data sources, allowing users to query public datasets like NYC 311 complaints and Google Data Commons using natural language.

Security Assessment
Overall Risk: Low. The tool makes external network requests to fetch public civic data from government APIs and read-only data portals. It does not request dangerous local permissions or access sensitive system files. A lightweight code scan of 12 files found no hardcoded secrets, suspicious obfuscation, or dangerous execution patterns. API keys for higher rate limits are properly managed via standard environment variables rather than being embedded in the codebase.

Quality Assessment
Quality: Good. The project is very active, with its last push occurring today. It has earned a respectable baseline of community trust with 23 GitHub stars and provides excellent, clear documentation aimed at helping civic technologists and journalists get started easily. The only notable drawback is the complete lack of a software license. Without a defined license, the code technically remains the exclusive intellectual property of the creator, which imposes strict legal limits on how others can modify, distribute, or use it in production.

Verdict
Safe to use for local experimentation and civic exploration, but use with caution if you plan to integrate it into a commercial or distributed product due to the unlicensed code.
SUMMARY

Open-source platform connecting AI assistants to government open data — MCP server, curated civic MCP directory, and anti-hallucination framework for all 559 Socrata portals

README.md

Civic AI Tools

Open in GitHub Codespaces

Use AI to explore NYC Open Data and Google Data Commons — no advanced programming required.

Civic AI Tools connects AI assistants (GitHub Copilot, Cursor, Claude Code) to public datasets using the Model Context Protocol (MCP). Think of MCP as a universal adapter that lets AI talk directly to data sources — so you can ask questions in plain English and get answers from real civic data.

Built for civic technologists, government workers, journalists, and students exploring public data with AI.

What can you do with this?

  • Ask questions about NYC 311 complaints, restaurant inspections, or housing violations in plain English
  • Pull population, income, and demographic data from Google Data Commons
  • Generate visualizations and dashboards from live civic datasets
  • Compare statistics across cities and time periods

Example queries you can ask:

  • "What are the top 311 complaint types in NYC?"
  • "Show me restaurant inspection grades by borough"
  • "Compare NYC's population trend with Los Angeles and Chicago"

Quick start

Option 1: GitHub Codespaces (recommended — nothing to install)

  1. Click the "Open in GitHub Codespaces" button above
  2. Wait for the environment to build (everything is installed automatically)
  3. Open Copilot Chat (sidebar chat icon or Ctrl+Shift+I), switch to Agent mode, and start asking questions

Optional: For higher rate limits, add Codespaces Secrets before launching:

  • Go to your fork's Settings > Secrets and variables > Codespaces
  • Add SOCRATA_APP_TOKEN (get one free)
  • Add DC_API_KEY (get one free) — required for Data Commons

Without API keys, NYC Open Data queries still work (with lower rate limits). Data Commons is skipped if no key is set.

Option 2: Local setup

git clone https://github.com/npstorey/civic-ai-tools.git
cd civic-ai-tools
cp .env.example .env       # Add your API keys (see file for instructions)
./scripts/setup.sh         # Builds MCP servers and generates config files

Then open the project in your preferred tool:

  • VS Code + Copilot — Reload window (Ctrl+Shift+P > "Developer: Reload Window"), use Copilot Chat in Agent mode
  • Cursor — Open the folder in Cursor (restart if MCP servers don't appear)
  • Claude Code — Run claude in this directory and approve the MCP servers when prompted

See docs/setup.md for detailed instructions and troubleshooting.

What's included

MCP Server Data Source What you can query
Socrata MCP NYC Open Data 311 complaints, restaurant inspections, housing violations, traffic data, and 2,000+ other datasets
Data Commons MCP Google Data Commons Population, income, demographics, and other statistical indicators across cities, states, and countries

Requirements (local setup only)

  • Node.js 18+
  • Python 3.11+
  • uv (recommended) — install with curl -LsSf https://astral.sh/uv/install.sh | sh

Example scripts

The examples/ directory contains standalone scripts you can run directly with uv:

uv run examples/real_data_analysis.py         # Fetch and analyze live NYC + Data Commons data
uv run examples/nyc_311_dashboard.py          # Launch a Streamlit dashboard of 311 data
uv run examples/create_html_visualizations.py # Generate an interactive HTML dashboard

See examples/README.md for the full list.

Related projects

Repository Description
socrata-mcp-server The MCP server that connects AI tools to Socrata open data portals. This repo uses it as a dependency.
civic-ai-tools-website Demo website at civicaitools.org — side-by-side comparison of AI with and without live data access

Documentation

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines — there are ways to help even if you don't write code.

Glossary

New to some of these terms? Here's a quick reference:

Term What it means
Repo (repository) A folder of code hosted on GitHub that tracks changes over time
Clone Download a copy of a repo to your computer
MCP Model Context Protocol — a standard way for AI tools to connect to external data sources
API Application Programming Interface — a way for programs to request data from a service
API key A password-like string that identifies you when making API requests
Codespace A cloud development environment that runs in your browser — no local setup needed

Disclaimer

This is a personal project and is not affiliated with, endorsed by, or representative of any employer or organization.

Yorumlar (0)

Sonuc bulunamadi