Skip to main content

MCP server for QAnon drops for sociological research

Project description

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

Q-Anon Posts/Drops MCP Server

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.

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.

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

Prerequisites

  • Python 3.10 or higher
  • uv package manager
  • Claude Desktop (for Claude integration)

Installation

This tool is compatible with uvx and doesn't need to be cloned/installed.

Manual

  1. Clone or download this repository to your local machine
  2. Install the required packages using uv:
uv pip install -e .

Usage

You can run the server directly with uvx:

uvx qanon_mcp

Claude Desktop Integration

To use this MCP server with Claude Desktop:

  1. Make sure you have Claude Desktop installed
  2. Open the Claude menu and select "Settings..."
  3. Click on "Developer" in the left-hand bar and then "Edit Config"
  4. Add the following configuration to the claude_desktop_config.json file:
{
  "mcpServers": {
    "qanon_mcp": {
      "command": "uvx",
      "args": [
        "qanon_mcp"
      ]
    }
  }
}

or, if you don't have uvx installed:

{
  "mcpServers": {
    "qanon_mcp": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "qanon_mcp"
      ]
    }
  }
}
  1. Save the file and restart Claude Desktop
  2. Start a new conversation in Claude Desktop
  3. You should see a hammer icon in the input box, indicating that tools are available

Features

Resources

  • qanon://posts/count - Get the total number of posts
  • qanon://posts/{post_id} - Access a specific post by ID
  • qanon://authors - List all unique authors
  • qanon://stats - Get dataset statistics

Tools

  • Search Posts - Find posts containing specific keywords
  • Get Posts by Date - Retrieve posts from a date range
  • Get Posts by Author ID - Find posts by a specific author
  • Analyze Post - Get detailed analysis of a specific post
  • Get Timeline Summary - Generate a chronological timeline

Example Queries for Claude

Once the MCP server is connected to Claude Desktop, you can ask questions like:

  • "How many Q-Anon posts are in the dataset?"
  • "Search for posts that mention 'storm'"
  • "Show me posts from October 2020"
  • "Analyze post #3725"
  • "Create a timeline of Q-Anon posts from 2018"

Troubleshooting

  • If Claude Desktop doesn't show the hammer icon, check your configuration and restart Claude Desktop
  • Ensure the qposts.json file is in the same directory as the script
  • Check the output in the terminal for any error messages
  • Make sure you're using the absolute path to the script in your Claude Desktop configuration

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qanon_mcp-0.2.0.tar.gz (858.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

qanon_mcp-0.2.0-py3-none-any.whl (856.6 kB view details)

Uploaded Python 3

File details

Details for the file qanon_mcp-0.2.0.tar.gz.

File metadata

  • Download URL: qanon_mcp-0.2.0.tar.gz
  • Upload date:
  • Size: 858.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.6.10

File hashes

Hashes for qanon_mcp-0.2.0.tar.gz
Algorithm Hash digest
SHA256 66a6bea409134c4209ebb33797be032ef2238bd211ea6c2b0e35515875ee8a1c
MD5 366cdd5a94ae4b4973b4717cbdc61719
BLAKE2b-256 16f9329af3edc5474d2eda63128abeaaabf59716335220eee5a282a2a89c8bce

See more details on using hashes here.

File details

Details for the file qanon_mcp-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: qanon_mcp-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 856.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.6.10

File hashes

Hashes for qanon_mcp-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2c0ebb06c193e68fa5405dab85e9077cfb89bfba07165f25dca8f7cbacf6cb8b
MD5 fac9ea2ff64d3fe61ae7abe52580d80f
BLAKE2b-256 78bb3ce0a94676ad9fc504d8e1fc9381078346648ab7cb9b0e1d9e73894a1471

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page