Skip to content

CLAUDE.md

Latest commit

 

History

History
40 lines (32 loc) · 1.34 KB

CLAUDE.md

File metadata and controls

40 lines (32 loc) · 1.34 KB
Raw

Project: AI Agent for Census API Datasets

An MCP server that powers an AI agent for working with Census API datasets.
It enables users to discover relevant datasets, construct API requests, and generate query URLs based on specific research questions.

Key Features

  • Dataset Discovery: Helps users identify relevant Census datasets for their research needs
  • Query Generation: Automatically builds API request URLs from natural language queries
  • Guided API Usage: Assists users in configuring API keys and understanding request structures
  • RAG Integration: Retrieves contextual information from dataset manuals to enhance query accuracy

Build and Run Commands

when develop this project, you will chage virtual env to ai_agent.

conda activate ai_agent

Python Style Guidelines

  • Formatting
    • Code is formatted using Black or Ruff
    • turning a tab into 4 white spaces
  • Imports Organize imports in the following order:
    • Standard library
    • Third-party packages
    • Local modules
  • Error Handling Use custom exceptions defined in app/core/exceptions.py
  • Modular Design Structure the codebase into modular components:
    • API request handling
    • RAG-based dataset manual retrieval
    • MCP server functions (e.g., generating API URLs, guiding API key setup, dataset selection)