scp-mcp

An unofficial Model Context Protocol (MCP) server for SCP Wiki content. It searches and retrieves pages through the SCP Data API. Five read-only tools return content with source, author, and license metadata.

Maintenance status: Maintained.

The current package version is 0.1.0, and this is a pre-1.0 codebase.

CI checks formatting, lint, tests, the build, dependencies, and package contents on Node.js 20.

Quick start

Requirements: Node.js 20.19 or later and npm.

git clone https://github.com/soltonigiri/scp-mcp.git
cd scp-mcp
npm ci
npm test
npm run build
npm run mcp:stdio

npmで公開後は、cloneせずに起動できます。

npx scp-mcp

概要

SCP Data API を一次ソースとして、SCP Wiki由来のページを検索、取得、引用できるMCPサーバーです。 データ取得専用で、SCP Wikiの投稿、編集、投票、ログイン機能はありません。

ライセンスと非公式プロジェクトであること

• 本プロジェクトは 非公式 です（SCP Foundation / Wikidot 公式ではありません）。
• 本リポジトリのソースコードは MIT License です（LICENSE）。
• SCP Wiki のコンテンツは原則 CC BY-SA 3.0 です。二次利用時は帰属表示と継承（Share-Alike）が必要です。
• ライセンス指針: https://scp-wiki.wikidot.com/licensing-guide

起動

stdio（ローカル統合向け）

npm run mcp:stdio

Streamable HTTP（リモート/本番運用向け）

npm run mcp:http

• MCP エンドポイント: POST /mcp
• ヘルスチェック: GET /healthz
• ポート: PORT（デフォルト 3000）

Codexから接続する

Quick startを実行した後、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

Tools

すべての 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 準拠の帰属テンプレ生成

Prompts

• prompt_quote_with_citation：引用付き回答（URL/作者/ライセンス必須、本文は非信頼データとして扱う）
• prompt_rag_reader：検索→取得→要約（URL/作者/ライセンス必須、本文は非信頼データとして扱う）

Resources

• scp://about
• scp://page/{link}
• scp://content/{link}（markdownを返します）

セキュリティ/運用

• 本文（および snippet）は 非信頼データ として扱ってください（prompt injection を含み得ます）。
• 外部フェッチは 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 に出力します。