gw150914 -signal-search

This MCP server pair provides gravitational wave analysis tools and an AI-assisted optimization client for GW150914 signal search. The GW Analysis Server exposes MCP endpoints for data fetching, matched-filter searches, multi-detector network analysis, and visualization of results. The Optimization Client uses an AI agent to steer the search over a 4D parameter space (mass1, mass2, right ascension, declination) by learning from historical results and current SNR feedback. Run the server to start analysis services, then launch the client to begin AI-guided parameter exploration. The system stores execution logs and results under data/logs and can visualize analysis outputs via the server’s plotting utilities.

Prerequisites:

• Python 3.9 or higher
• UV package manager (uv)

Installation steps:

1. Install UV (if not already installed):

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Clone the repository and set up the project:

git clone <repository-url>
cd gw150914-mcp-signal-search
make setup

3. Configure environment variables:

cp env.template .env
# Edit .env to set your OPENAI_API_KEY and any other needed vars

4. Install dependencies (development):

make install-dev

5. Run the demo or start components as needed:

# Start a server and client
make run-client SERVER_PATH=mcp-server/gw_analysis_server.py

# Or run the full demo
make demo

Notes and tips:

• Environment variables: set OPENAI_API_KEY for the optimization client. The server may also reference DATA_PATH and LOG_DIR to locate data and store logs.
• Data handling: strain data and results live under data/; matched_filter_records.jsonl contains optimization history.
• Logs: execution logs are saved under data/logs with timestamps for debugging.
• If you encounter port or path issues, ensure the working directory is the repository root and that the Python path includes the mcp-server directory.
• For production, consider separating the server and client into distinct processes or containers and redirect logs to a centralized location.