MCPサーバー連携ガイドの変更点

追加された行はこの色です。
削除された行はこの色です。
MCPサーバー連携ガイドへ行く。
MCPサーバー連携ガイドの差分を削除
#author("2026-09-04T00:00:40+09:00","default:mcp","bot-mcp")
#author("2026-09-04T10:46:13+09:00","default:mcp","bot-mcp")
* MCPサーバー連携ガイド [#jc18739c]
ボットAPI (bot.inc.php) を利用して、AI（VS Code、Claude Code、Antigravityなど）とWikiを直接接続するMCP (Model Context Protocol) サーバーの導入手順です。
ボットAPI (bot.inc.php) を利用して、AI（VS Code、Claude Desktop、Cursor、Claude Code、Antigravityなど）とWikiを直接接続するMCP (Model Context Protocol) サーバーの導入手順です。

#contents

** 概要 [#vad4f41b]
MCPサーバーを経由することで、AIがチャットを通じてWikiページの検索、閲覧、新規作成、編集を行えるようになります。
MCPサーバーを経由することで、AIエージェントがチャットや対話ツールを通じてWikiページの検索、閲覧、新規作成、更新、削除を直接実行できるようになります。

** 配布リポジトリ [#package_repo]
MCPサーバーはオープンソースとしてGitHubおよびnpmで配布されています。
GitHubから直接ダウンロードまたはクローンして利用するか、npxコマンドによりインストール不要で即時実行できます。

- GitHubリポジトリ: [[PTOM76/pukibot-mcp>https://github.com/PTOM76/pukibot-mcp]]
- npmパッケージ名: pukibot-mcp
- ライセンス: MIT License

** 提供機能 (MCP Tools) [#z0b619f0]
MCPサーバーから以下のツールが提供されます。

|~ツール名|~説明|
|pukiwiki_read_page|指定したページのWikiソースコードとメタデータを取得|
|pukiwiki_write_page|ページの新規作成または上書き編集（PukiWiki記法）|
|pukiwiki_delete_page|指定したページの削除|
|pukiwiki_search|キーワードによるページ内検索（AND / OR）|
|pukiwiki_list_recent|最近更新されたページ一覧の取得|
|pukiwiki_get_diff|ページの変更差分（diff）の取得|
|pukiwiki_get_backup|バックアップ履歴および過去バージョンの取得|
|pukiwiki_check_permission|APIトークンの権限確認|
|~ツール名|~説明|~主要引数|
|pukiwiki_read_page|指定したページのWikiソースコードとメタデータを取得|page_name|
|pukiwiki_write_page|ページの新規作成や上書き更新|page_name, content, notimestamp|
|pukiwiki_delete_page|指定したページの削除|page_name|
|pukiwiki_list_pages|Wiki内の全ページ名一覧を取得|なし|
|pukiwiki_search_pages|キーワードによるページ内検索（AND / OR）|query, type|
|pukiwiki_get_recent_changes|最近更新されたページ一覧を取得|limit|
|pukiwiki_get_version|PukiWikiおよびbotプラグインのバージョン情報を取得|なし|
|pukiwiki_backup_page|バックアップ一覧や過去バージョンの取得|page_name, age|

** 設定手順 [#u0d98dbe]

*** 1. ボットAPIトークンの準備 [#a1270a14]
Wikiの管理画面（コントロールパネル > 詳細設定 > プラグイン設定 > ボットAPI設定ページ）からトークンを発行し、BOT_PERMISSION_PAGE_ALL 権限を付与します。
bot.inc.php プラグイン自体の入手先は [[自作プラグイン/bot.inc.php>https://pukiwiki.sourceforge.io/?%E8%87%AA%E4%BD%9C%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3/bot.inc.php]] を参照してください。

*** 2. VS Code 設定 (.vscode/mcp.json) [#p1c90447]
プロジェクトルートの .vscode/mcp.json に以下を記述します。
VS Code（GitHub Copilot Agent Mode等）で利用する場合、プロジェクトの .vscode/mcp.json に以下を記述します。

#code(json){{
{
  "mcpServers": {
  "servers": {
    "pukiwiki": {
      "command": "node",
      "args": ["${workspaceFolder}/mcp/server.js"],
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "pukibot-mcp"],
      "env": {
        "PUKIWIKI_URL": "https://wikichree.com/YOUR_WIKI/index.php",
        "PUKIWIKI_TOKEN": "YOUR_TOKEN_HERE",
        "PUKIWIKI_BOT_NAME": "vscode-ai"
      }
    }
  }
}
}}

*** 3. Claude Code 設定 (.mcp.json) [#r4c4ac96]
プロジェクト直下に .mcp.json を配置するか、以下のコマンドを実行します。
*** 3. Claude Desktop 設定 (claude_desktop_config.json) [#claude_desktop]
Claude Desktopの設定ファイルに以下を追加します。

#code(json){{
{
  "mcpServers": {
    "pukiwiki": {
      "command": "npx",
      "args": ["-y", "pukibot-mcp"],
      "env": {
        "PUKIWIKI_URL": "https://wikichree.com/YOUR_WIKI/index.php",
        "PUKIWIKI_TOKEN": "YOUR_TOKEN_HERE",
        "PUKIWIKI_BOT_NAME": "claude-desktop"
      }
    }
  }
}
}}

*** 4. Claude Code 設定 [#r4c4ac96]
Claude CodeのCLI環境では以下のコマンドを実行して追加します。

#code(bash){{
claude mcp add pukiwiki node ./mcp/server.js -e PUKIWIKI_URL=https://wikichree.com/YOUR_WIKI/index.php -e PUKIWIKI_TOKEN=YOUR_TOKEN_HERE
claude mcp add pukiwiki npx -y pukibot-mcp -e PUKIWIKI_URL=https://wikichree.com/YOUR_WIKI/index.php -e PUKIWIKI_TOKEN=YOUR_TOKEN_HERE
}}

** AIによるページ編集時の注意点 [#je43d6ae]
AIがWikiページを作成または編集する場合、Markdown記法ではなくPukiWiki記法を使用します。

- 見出し: * (大見出し), ** (中見出し), *** (小見出し)
- リスト: - (箇条書き), -- (ネスト)
- 表組み: |~見出し|~見出し| / |内容|内容|
- リンク: [[ページ名]] または [[リンク名>URL]]
- 水平線: ----
- コードブロック: #code{{ ... }} または #code(言語名){{ ... }}

----
[[ボットAPI]]
WikiChreeガイド

最新の20件
