scp MCP

scp-mcp

SCP Data API 作为主源SCP Wiki由来的页面 検索・取得・引用 能Model Context Protocol（MCP）服务器。

重要（许可证/非正式）

• 项目名称 非公式 （不是SCP Foundation/Wikidot公式）。
• 本存储库的源代码为 MIT许可证 表示LICENSE）。
• SCP Wiki 原则内容 CC BY SA 3.0 是。二次使用时需要归属表示和继承。
• 请特别注意图像和介质的处理（例如：SCP-173 的过去的图像有追加的限制，不能商用利用）。
• 许可指南：https://scp-wiki.wikidot.com/licensing-guide

安装，安装

npm install
npm test
npm run build

起动

stdio（本地集成

npm run mcp:stdio

Streamable HTTP（远程/生产）

npm run mcp:http

• MCP 端点： POST /mcp
• 健康检查： GET /healthz
• 端口： PORT（默认值 3000）

快速启动

首先clone 加入依赖。

git clone https://github.com/soltonigiri/scp-mcp.git
cd scp-mcp
npm install

下一个Codex 的，之 config.toml 中添加以下内容（{scp-mcp-path} 啊clone ），模板名称将采用不同的格式。

[mcp_servers.scp-mcp]
command = "bash"
args = ["-lc", "cd {scp-mcp-path} && npm run --silent mcp:stdio"]
startup_timeout_ms = 20000

工具（MVP）

所有tool 返回值为 structuredContent 的JSON （另外，由于可读性 content[type=text] 也JSON 返回字符串）。

• scp_search：按关键字/标记/系列搜索（带snippet）
• scp_get_page：link/scp_number/page_id 页面元数据检索
• scp_get_content：本文取得（markdown|text|html|wikitext）
• scp_get_related：references/hubs 的相关提取（relation_type 付与）
• scp_get_attribution：CC BY-SA 3.0 相容性归属

提示

• prompt_quote_with_citation：引用回答（URL/作者/必须许可，正文作为非信任数据处理）
• prompt_rag_reader：检索→获取→摘要（URL/作者/必须许可，正文作为非信赖数据处理）

资源

• scp://about
• scp://page/{link}
• scp://content/{link}（markdown），模板名称将采用不同的格式

安全/操作

• 正文（和snippet）啊 不信任数据 中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。
• 外部读取 https://scp-data.tedivm.com/data/scp/ 在属下用许可列表限制着（SSRF对策）。
• Rate limit（tool 调用单位，固定窗口）：

- SCP_MCP_RATE_LIMIT_WINDOW_MS（默认值： 60000） - SCP_MCP_RATE_LIMIT_MAX_REQUESTS（默认值： 60）

• 审计日志（tools/call参数和结果元，不保存正文）：

- SCP_MCP_AUDIT_LOG_PATH 来定义自定义外观JSONL 列表框中，此格式对应于条目“无”。如果未设定stderr 中所述修改相应参数的值。