JinDaGe - qanon-mcp-server MCP Details

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

手动安装

克隆或下载此仓库到您的本地计算机。
使用 uv 安装所需的软件包：

uv pip install -e .

💻 使用示例

基础用法

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

uvx qanon_mcp

与 Claude Desktop 集成

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

确保安装了 Claude Desktop。
打开 Claude 菜单，选择“设置...”。
点击左侧栏的“开发者”，然后点击“编辑配置”。
将以下配置添加到 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "qanon_mcp": {
      "command": "uvx",
      "args": [
        "qanon_mcp"
      ]
    }
  }
}

或者，如果您没有安装 uvx：

{
  "mcpServers": {
    "qanon_mcp": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "qanon_mcp"
      ]
    }
  }
}

保存文件并重新启动 Claude Desktop。
启动新的对话。
您应该会在输入框中看到锤子图标，表示工具可用。

示例查询（用于 Claude）

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

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

📚 详细文档

注意事项

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

qanon-mcp-server