Skip to content

boykush/wiki-remote-mcp

v0.1.0

Remote MCP server for boykush's Scraps wiki. Search and read the wiki from any repository without restating the server in each one.

wiki-remote-mcp

この wiki を引くための remote MCP サーバーへの参照を1つ持つだけの plugin。Agent Plugins の形で書く。名前の remote は、ローカルで scraps mcp serve を立てる経路と区別するためのもの。そちらは scraps 本体の mcp-server plugin が配る。

サーバー名は scraps。tool は mcp__scraps__* として見える(search_scraps / get_scrap / lookup_scrap_links など)。~/.claude/CLAUDE.md(dotfiles の agents/AGENTS.md)の手順がこの名前を前提にしているので、変えない。

配る中身

mcp.json の、https://wiki-mcp.boykush.com/mcp への参照だけ。実体は2つの repo に分かれている。

  • image はこの repo の CI が wiki の内容ごとビルドして ghcr.io/boykush/wiki-mcp-server へ push する。したがって引ける内容は main に push 済みのもので、手元の未 push な編集は含まれない
  • 動く場所と hostname は infrastructure-as-code の applications/remote-mcp-server/。URL が変わるならここが先に変わり、mcp.json が後を追う

繋がらないときは公開サイト https://boykush.github.io/wiki/ を見る。

使う

apm で受け取るなら、ai-plugins がこの plugin から作る package に依存する。apm は Agent Plugins の形を Claude と Codex へは展開しないので、その変換を ai-plugins が持つ。

dependencies:
  apm:
    - boykush/ai-plugins/plugins/wiki-remote-mcp
apm install

Claude は .mcp.json、Codex は .codex/config.toml に入る。どちらも project scope なので、リポジトリに commit すればそのリポジトリで開いた全セッションに効く。

Claude の .mcp.json は本来リポジトリごとに承認プロンプトが出るが、~/.claude/settings.json の enabledMcpjsonServers に scraps が入っているので出ない。入っていないマシンでは1回承認する。