GSS Research Center

Overview

The General Social Survey (GSS) Research Center is a comprehensive data analysis platform for exploring social science research data. This project provides both REST API access and MCP (Model Context Protocol) integration for analyzing GSS survey data spanning 1972-2024.

Features

• Real Database Integration: Access to 75,699+ GSS participants and 108,871+ survey responses
• REST API: FastAPI-based endpoints for data analysis and visualization
• MCP Server: AI-powered research tools for social science analysis
• Performance Optimized: Thread-safe database connections and request tracking
• Cross-Platform: Supports Windows/WSL development environments

Architecture Versions

Current Stable (v0.92)

• Hybrid MCP/REST server architecture
• Mock data for development and testing
• Basic frontend integration
• Launcher: python3 run_gss_v092.py

Development (v0.93+)

• Separated MCP and REST servers (prevents SQL conflicts)
• Real GSS database integration (75K+ participants)
• Production-ready error handling and logging
• Branch: gss-v093

Quick Start

Prerequisites

• Python 3.9+
• SQL Server with GSS database access (for production versions)
• Windows environment (for pyodbc integration)

Running the Application

Stable Version (v0.92):

python3 run_gss_v092.py

Development Version (v0.93):

git checkout gss-v093
python3 run_gss_v093.py

Project Structure

gss-research-center/
├── rest-api/           # FastAPI REST server
├── mcp-server/         # MCP protocol server
├── frontend-updates/   # UI components and updates
├── run_gss_v*.py      # Version-specific launchers
└── test_*.py          # Testing utilities

Development Workflow

1. Main Branch: Stable releases and documentation
2. Version Branches: Feature development (gss-v093, gss-v094, etc.)
3. Testing: Each version includes comprehensive test suites

Contributing

This is a research project. See version-specific branches for development guidelines.

License

Private research project.