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.

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

  1. Clone or download this repository to your local machine
  2. Install the required packages using uv:
uv pip install "mcp[cli]"

Usage

You can run the server directly with uv:

uv run qanon_mcp_server.py

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-explorer": {
      "command": "uv",
      "args": [
        "run",
        "/ABSOLUTE/PATH/TO/qanon_mcp_server.py"
      ]
    }
  }
}

Replace /ABSOLUTE/PATH/TO/qanon_mcp_server.py with the absolute path to your qanon_mcp_server.py file.

For Windows users, the path should use double backslashes:

{
  "mcpServers": {
    "qanon-explorer": {
      "command": "uv",
      "args": [
        "run",
        "C:\\Users\\YourUsername\\Path\\To\\qanon_mcp_server.py"
      ]
    }
  }
}
  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.1.2.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.1.2-py3-none-any.whl (856.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: qanon_mcp-0.1.2.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.1.2.tar.gz
Algorithm Hash digest
SHA256 cb432d5c620659204482344c8b28ad9e03739ee95157ea5dd503628d323de8b3
MD5 76f22559b64338871cdb807d56f6013c
BLAKE2b-256 98636718b00fbf27130101836a3a0bd20fa40a3a1a8cff6079183edb6d4b07c1

See more details on using hashes here.

File details

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

File metadata

  • Download URL: qanon_mcp-0.1.2-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.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 9178e89a3c3f79a8e7eaf4cbf1c829ef931cc46a8e914f0925fd2d55ac7ae9ad
MD5 32584def8dc3b221652e6e8ec0c5bbaa
BLAKE2b-256 aae81221528cbde545edf212e754b960375889c5c600c900c8c1d7cb0233bef2

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