Skip to main content
Glama
deenesjakoruzh
keenanpepper

glowfic-rag

by keenanpepper
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

glowfic-rag

针对 glowfic.com 内容的语义搜索，作为 MCP 服务器暴露给 Claude Code 和 Cursor 使用。

使用存储在 ChromaDB 中的 GTE-Large 嵌入。预构建的索引涵盖了约 65.8 万条帖子，来源包括：

  • planecrash (版块 215) — 1.9 万条帖子，28 个主题

  • Sandboxes (版块 3) — 63.9 万条帖子，2,214 个主题

  • trainwreck (版块 277) — 595 条帖子，7 个主题

版块结构抓取 (src/render.py, src/auth.py) 源自 Roger Curley 和 Alyssa Riceman 开发的 rocurley/glowfic-dl。

快速开始

需要 Python 3.10+ (mcp 包需要此版本)。

git clone https://github.com/keenanpepper/glowfic-rag.git
cd glowfic-rag

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# Download the pre-built vector database (~2GB compressed, ~5GB on disk)
./setup_data.sh

Related MCP server: MCP Codebase RAG Server

在 Claude Code 中使用

该仓库包含 .mcp.json，Claude Code 会自动检测。在仓库目录下：

claude

Claude 将能够访问 search_glowfic 和 list_indexed_continuities 工具。

在 Cursor 中使用

创建 .cursor/mcp.json 并填入你克隆仓库的绝对路径：

{
  "mcpServers": {
    "glowfic-search": {
      "command": "/path/to/glowfic-rag/.venv/bin/python3",
      "args": ["-m", "rag.mcp_server"],
      "cwd": "/path/to/glowfic-rag"
    }
  }
}

然后重新加载 Cursor 窗口。

命令行搜索

你也可以通过命令行进行搜索：

python -m rag.search "Keltham explains expected utility" -k 5
python -m rag.search "vampire meets werewolf" --continuity Sandboxes
python -m rag.search "dath ilan" --author Iarwain

添加更多连续性内容

将版块抓取为 JSONL，然后将其添加到索引中：

# Scrape (supports --resume for interrupted runs)
python -m rag.scrape https://glowfic.com/boards/277

# Index (adds to existing collection, doesn't rebuild)
python -m rag.index data/trainwreck.jsonl

# Or reindex everything from scratch
python -m rag.index --reset

抓取器会自动处理大型版块的分页，并自动重试受限的请求。

性能说明

  • 首次查询: ~10 秒（模型加载 + 索引预热）

  • 后续查询: < 1 秒

  • 内存: 模型 + 索引加载时约 3-5GB

  • 磁盘: ChromaDB 索引约 5GB

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers