# Community Archive MCP Server

A remote MCP (Model Context Protocol) server that allows Claude to query the [Community Archive](https://github.com/TheExGenesis/community-archive) - a preserved Twitter data archive.

## Features

- **search_tweets** - Search tweets across all archived users by keyword
- **get_user_profile** - Get profile info for a specific username
- **get_user_tweets** - Get tweets from a specific user
- **list_archived_users** - List all users in the archive

## Setup

### Prerequisites

- [Bun](https://bun.sh/) runtime
- [Cloudflare account](https://dash.cloudflare.com/sign-up)
- Community Archive Supabase API key

### Installation

```bash
bun install
```

### Configuration

1. Set your Supabase API key as a secret:
```bash
bunx wrangler secret put SUPABASE_KEY
```

2. (Optional) Update `wrangler.toml` if using a different Supabase instance

### Local Development

```bash
bunx wrangler dev
```

The server will be available at `http://localhost:8787`

### Deploy

```bash
bunx wrangler deploy
```

After deployment, your MCP server will be available at:
- `https://community-archive-mcp.<your-subdomain>.workers.dev`

## Connecting to Claude

### Claude Web / Claude Desktop

1. Go to Settings > MCP Servers
2. Add a new remote server with URL: `https://community-archive-mcp.<your-subdomain>.workers.dev/sse`

### Endpoints

- `/` - Server info and available tools
- `/sse` - SSE transport endpoint (for Claude Web)
- `/mcp` - Streamable HTTP endpoint

## Example Usage

Once connected, you can ask Claude things like:

- "Search for tweets about 'machine learning'"
- "Show me the profile for @username"
- "Get the last 20 tweets from username"
- "List all users in the Community Archive"

## License

MIT