返回 MCP 目录
public公开dns本地运行

qanon-mcp-server

一个提供QAnon帖子数据集访问的MCP服务器,用于人类学/社会学研究分析

article

README

🚀 QAnon MCP 服务器项目

QAnon 是一个危险的邪教组织。此存档仅用于研究用途,本项目不认可此存储库中的任何材料。本项目提供一个 MCP(模型上下文协议)服务器,用于人种学/社会学研究,可让 AI 助手对 Q - Anon 帖子数据集进行搜索、过滤和分析。

🚀 快速开始

本项目是一个 MCP(模型上下文协议)服务器,提供对 Q - Anon 帖子数据集的访问,专门用于人种学/社会学研究。此服务器支持像 Claude 这样的 AI 助手对 Q - Anon 的帖子进行搜索、过滤和分析。

帖子数据来源于 https://github.com/jkingsman/JSON - QAnon ,您可以在该链接了解更多有关源数据的组成信息,还能找到其他格式、架构等内容。

警告 ⚠️

此工具完全是 vibe 编码的,请自行承担风险使用。

服务器徽章 [![smithery 徽章](https://smithery.ai/badge/@jkingsman/qanon - mcp - server)](https://smithery.ai/server/@jkingsman/qanon - mcp - server)

✨ 主要特性

资源

  • qanon://posts/count - 获取帖子总数
  • qanon://posts/{post_id} - 通过 ID 访问特定帖子
  • qanon://posts/raw/{post_id} - 获取特定帖子的原始 JSON 数据
  • qanon://authors - 列出所有唯一作者
  • qanon://stats - 获取数据集统计信息

工具

  • get_post_by_id_tool - 通过 ID 检索特定帖子
  • search_posts - 查找包含特定关键词或短语的帖子
  • get_posts_by_date - 在特定日期范围内检索帖子
  • get_posts_by_author_id - 根据作者 ID 找到帖子
  • analyze_post - 获取特定帖子的详细分析,包括引用和上下文
  • get_timeline_summary - 生成按时间顺序排列的时间线,可选在特定日期范围内
  • word_cloud_by_post_ids - 为指定 ID 范围内的帖子生成单词频率分析
  • word_cloud_by_date_range - 为特定日期范围内的帖子生成单词频率分析

📦 安装指南

先决条件

  • Python 3.10 或更高版本
  • uv 包管理器
  • Claude Desktop(用于与 Claude 集成)

安装方式

此工具兼容 uvx,无需克隆/安装。

通过 Smithery 安装

要通过 [Smithery](https://smithery.ai/server/@jkingsman/qanon - mcp - server) 自动为 Claude Desktop 安装 qanon - mcp - server,可使用以下命令:

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

手动安装

  1. 克隆或下载此仓库到您的本地计算机。
  2. 使用 uv 安装所需的软件包:
uv pip install -e .

💻 使用示例

基础用法

可以直接使用 uvx 运行服务器:

uvx qanon_mcp

与 Claude Desktop 集成

要将此 MCP 服务器与 Claude Desktop 一起使用,可按以下步骤操作:

  1. 确保安装了 Claude Desktop
  2. 打开 Claude 菜单,选择“设置...”。
  3. 点击左侧栏的“开发者”,然后点击“编辑配置”。
  4. 将以下配置添加到 claude_desktop_config.json 文件中:
{
  "mcpServers": {
    "qanon_mcp": {
      "command": "uvx",
      "args": [
        "qanon_mcp"
      ]
    }
  }
}

或者,如果您没有安装 uvx

{
  "mcpServers": {
    "qanon_mcp": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "qanon_mcp"
      ]
    }
  }
}
  1. 保存文件并重新启动 Claude Desktop。
  2. 启动新的对话。
  3. 您应该会在输入框中看到锤子图标,表示工具可用。

示例查询(用于 Claude)

一旦 MCP 服务器连接到 Claude Desktop,您可以提出类似以下问题:

  • “数据集中有多少个 Q - Anon 帖子?”
  • “显示帖子 ID 12345 的内容。”
  • “在 2023 年 10 月期间发布了多少帖子?”
  • “找出作者 ID 6789 的所有帖子。”

📚 详细文档

注意事项

  • 确保 posts.json 文件与脚本在同一目录中。
  • 检查终端中的任何错误消息。
  • 确保在 Claude Desktop 配置中使用绝对路径的脚本。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端