QAnon is a dangerous cult. This archive is for research purposes only, and I do not endorse any material in this repo.x000D

x000D

Q-Anon Posts/Drops MCP Server_x000D_

x000D x000D x000D x000D An MCP (Model Context Protocol) server that provides access to a dataset of Q-Anon posts for anthropological/sociological research. This server allows AI assistants like Claude to search, filter, and analyze the Q-Anon drops.x000D x000D Posts are drawn from https://github.com/jkingsman/JSON-QAnon. You can learn more about how the source data was composed there, as well as find alternate formats, schemas, etc.x000D x000D

Warning: This tool was entirely vibe coded. Use at your own risk.x000D

x000D

Prerequisites_x000D_

x000D

• Python 3.10 or higher_x000D_
• uv package manager_x000D_
• Claude Desktop (for Claude integration)x000D x000D

Installation_x000D_

x000D This tool is compatible with uvx and does not need to be cloned/installed.x000D x000D

Installing via Smithery_x000D_

x000D To install qanon-mcp-server for Claude Desktop automatically via Smithery:x000D x000D

npx -y @smithery/cli install @jkingsman/qanon-mcp-server --client claude_x000D_
```_x000D_
_x000D_
### Manual_x000D_
_x000D_
1. Clone or download this repository to your local machine_x000D_
2. Install the required packages using `uv`:_x000D_
_x000D_
```bash_x000D_
uv pip install -e ._x000D_
```_x000D_
_x000D_
## Usage_x000D_
_x000D_
You can run the server directly with `uvx`:_x000D_
_x000D_
```bash_x000D_
uvx qanon_mcp_x000D_
```_x000D_
_x000D_
## Claude Desktop Integration_x000D_
_x000D_
To use this MCP server with Claude Desktop:_x000D_
_x000D_
1. Make sure you have [Claude Desktop](https://claude.ai/download) installed_x000D_
2. Open the Claude menu and select "Settings..."_x000D_
3. Click on "Developer" in the left-hand bar and then "Edit Config"_x000D_
4. Add the following configuration to the `claude_desktop_config.json` file:_x000D_
_x000D_
```json_x000D_
{_x000D_
  "mcpServers": {_x000D_
    "qanon_mcp": {_x000D_
      "command": "uvx",_x000D_
      "args": [_x000D_
        "qanon_mcp"_x000D_
      ]_x000D_
    }_x000D_
  }_x000D_
}_x000D_
```_x000D_
_x000D_
or, if you do not have `uvx` installed:_x000D_
_x000D_
```json_x000D_
{_x000D_
  "mcpServers": {_x000D_
    "qanon_mcp": {_x000D_
      "command": "uv",_x000D_
      "args": [_x000D_
        "tool",_x000D_
        "run",_x000D_
        "qanon_mcp"_x000D_
      ]_x000D_
    }_x000D_
  }_x000D_
}_x000D_
```_x000D_
_x000D_
_x000D_
5. Save the file and restart Claude Desktop_x000D_
6. Start a new conversation in Claude Desktop_x000D_
7. You should see a hammer icon in the input box, indicating that tools are available_x000D_
_x000D_
## Features_x000D_
_x000D_
### Resources_x000D_
_x000D_
- `qanon://posts/count` - Get the total number of posts_x000D_
- `qanon://posts/{post_id}` - Access a specific post by ID_x000D_
- `qanon://posts/raw/{post_id}` - Get the raw JSON data for a specific post_x000D_
- `qanon://authors` - List all unique authors_x000D_
- `qanon://stats` - Get dataset statistics_x000D_
_x000D_
### Tools_x000D_
_x000D_
- **get_post_by_id_tool** - Retrieve a specific post by its ID_x000D_
- **search_posts** - Find posts containing specific keywords or phrases_x000D_
- **get_posts_by_date** - Retrieve posts from a specific date range_x000D_
- **get_posts_by_author_id** - Find posts by a specific author ID_x000D_
- **analyze_post** - Get detailed analysis of a specific post including references and context_x000D_
- **get_timeline_summary** - Generate a chronological timeline, optionally within a date range_x000D_
- **word_cloud_by_post_ids** - Generate a word frequency analysis for posts within a specified ID range_x000D_
- **word_cloud_by_date_range** - Generate a word frequency analysis for posts within a specified date range_x000D_
_x000D_
## Example Queries for Claude_x000D_
_x000D_
Once the MCP server is connected to Claude Desktop, you can ask questions like:_x000D_
_x000D_
- "How many Q-Anon posts are in the dataset?"_x000D_
- "Search for posts that mention 'storm'"_x000D_
- "Show me posts from October 2020"_x000D_
- "Analyze post #3725"_x000D_
- "Create a timeline of Q-Anon posts from 2018"_x000D_
- "Generate a word cloud for Q-Anon posts between January and March 2019"_x000D_
- "Get the raw data for post #4500"_x000D_
- "What are the most common words used in posts #1000-2000?"_x000D_
_x000D_
## Troubleshooting_x000D_
_x000D_
- If Claude Desktop does not show the hammer icon, check your configuration and restart Claude Desktop_x000D_
- Ensure the `posts.json` file is in the same directory as the script_x000D_
- Check the output in the terminal for any error messages_x000D_
- Make sure you're using the absolute path to the script in your Claude Desktop configuration_x000D_