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

smithery badge

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.

Installing via Smithery

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

npx -y @smithery/cli install @jkingsman/qanon-mcp-server --client claude

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.3.0.tar.gz (860.5 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.3.0-py3-none-any.whl (858.5 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for qanon_mcp-0.3.0.tar.gz
Algorithm Hash digest
SHA256 524e7746cd827028a442c3f8ebd3e519c81cd4311add336e5659fe45394a4a66
MD5 c8be4e6541a0d8aa003d1d7d6091bca2
BLAKE2b-256 3d47ce55806484295dcea8d3df2381b0d7ae14dc32585361d60d975e8a826c20

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for qanon_mcp-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bc558bcd4a70e1ae336d9849470a73b7a5247db94a9fe6e22edfb325d6face66
MD5 8d8ec1f57a2e31cc4ccb8552f3282303
BLAKE2b-256 307607cebc4503132d242e209e38293ac993c700897a3d07600cb1907b054282

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