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.1.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.1-py3-none-any.whl (856.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: qanon_mcp-0.1.1.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.1.tar.gz
Algorithm Hash digest
SHA256 ebd49b7bce0e165fee0bf6e8cc3a0128dc4b8d1d7aec44ac2fcad44e6627c218
MD5 e379303089479cda43ab7b0e7df188c1
BLAKE2b-256 7b1f9ecb0857e4795efedad9ae574959434c9ee0586a6b64bb9da3b7625c3082

See more details on using hashes here.

File details

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

File metadata

  • Download URL: qanon_mcp-0.1.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5d169c22d89d0ef3a2bc08065e5ef0cf719aa089d0b0ba0681221bceb7fb607a
MD5 21d57425760c6e34254eccb949bae6b2
BLAKE2b-256 35c50021d3d4f3521e565fd81e51aa5f30c4c872b9ccc5b390e143994d41b6c1

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