BcMcpは、baserCMSを外部のAIエージェントから直接操作できるようにするMCP（Model Context Protocol）サーバーです。
', + 'detail' => $this->getDetail(), + ]); + + // ツール実行時に例外が発生していない事を確認 + $this->assertFalse($isError, 'ツールの実行に失敗しました。' . (is_string($result)? $result : json_encode($result, JSON_UNESCAPED_UNICODE))); + // ブログ記事が登録されている事を確認 + $this->assertArrayHasKey('id', $result, 'ブログ記事の登録に失敗しました。' . json_encode($result, JSON_UNESCAPED_UNICODE)); + $this->assertEquals('BcMcpについて', $result['title']); + $this->assertEquals('about-bcmcp', $result['name']); + $this->assertEquals(1, $result['blog_content_id']); + // McpContext 経由でログインユーザーが反映されている事を確認 + $this->assertEquals(1, $result['user_id']); + $this->assertFalse($result['status']); + } +``` + +- [ ] **Step 2: テストを実行して通ることを確認する** + +Run: `docker exec basercms sh -c 'cd /var/www/html && vendor/bin/phpunit --no-coverage plugins/bc-mcp/tests/TestCase/Mcp/McpServerToolCallTest.php 2>&1 | tail -25'` + +Expected: PASS。`user_id` が 1 になっていれば `McpContext` 方式が機能している。 + +- [ ] **Step 3: コミット** + +```bash +git add plugins/bc-mcp/tests/TestCase/Mcp/McpServerToolCallTest.php +git commit -m "ツール実行テストをプロセス内実行の新基盤へ移植" +``` + +--- + +### Task 6: プロキシの移植（内部 HTTP 転送の廃止） + +**Files:** +- Modify: `plugins/bc-mcp/src/Controller/McpProxyController.php` +- Test: `plugins/bc-mcp/tests/TestCase/Controller/McpProxyControllerTest.php` +- Modify: `plugins/bc-mcp/tests/TestCase/Controller/Admin/OAuth2ControllerTest.php` + +**Interfaces:** +- Consumes: `McpRequestHandler::handle()`（Task 2）、`McpContext`（Task 2） +- Produces: + - `McpProxyController::toMcpMessage(array $mcpRequest): \Mcp\Server\Transport\Http\HttpMessage` + +**`OAuth2ControllerTest` の常駐サーバー依存の解消（必須）** + +`OAuth2ControllerTest` は MCP プロキシ経由の統合テストのために、`McpServerManger::startMcpServer()` で**実際に常駐 MCP サーバー（SSE / `127.0.0.1:3000`）を起動していた**。in-process 化により起動自体が不要になるため、次を削除する。 + +- `use BcMcp\Mcp\McpServerManger;` +- サーバーを起動・停止するセットアップ／ティアダウン（`startMcpServer()` / 停止処理 / ポートへの接続待ちループ / `bc_mcp_server.log` の読み出し） + +統合テストは常駐サーバーを起動せず `/bc-mcp` を POST するだけでよい（プロキシが同一プロセスで SDK を実行するため）。この修正を行うまで `OAuth2ControllerTest` はエラー1・失敗2の状態になる。 + +- [ ] **Step 1: リクエスト変換を検証する失敗するテストを書く** + +Create: `plugins/bc-mcp/tests/TestCase/Controller/McpProxyControllerTest.php` + +```php + + * Copyright (c) NPO baser foundation本文
', + 'page_template' => '', + 'content' => [ + 'title' => 'ページタイトル', + 'name' => 'about', + 'parent_id' => 1, + 'site_id' => 1, + 'plugin' => 'BaserCore', + 'type' => 'Page', + 'self_status' => true, + ], +] +``` + +`plugin` = `'BaserCore'`、`type` = `'Page'` は固定値であり、**ツール側で自動的に補う**（AI クライアントに指定させない）。 + +- [ ] **Step 1: 失敗するテストを書く** + +Create: `plugins/bc-mcp/tests/TestCase/Mcp/BaserCore/PagesToolTest.php` + +```php + + * Copyright (c) NPO baser foundation会社概要のページです。
', + 'status' => 1, + ]); + + $this->assertFalse($isError, 'ツールの実行に失敗しました。' . (is_string($result)? $result : json_encode($result, JSON_UNESCAPED_UNICODE))); + $this->assertArrayHasKey('id', $result, json_encode($result, JSON_UNESCAPED_UNICODE)); + // 本文は pages.contents に保存される + $this->assertEquals('会社概要のページです。
', $result['contents']); + // タイトルと URL はコンテンツ情報に保存される + $this->assertEquals('会社概要', $result['content']['title']); + $this->assertEquals('about', $result['content']['name']); + // plugin と type はツール側で補われる + $this->assertEquals('BaserCore', $result['content']['plugin']); + $this->assertEquals('Page', $result['content']['type']); + } + + /** + * test editPage で固定ページが編集できる + */ + public function testEditPage() + { + $this->loadFixtureScenario(InitAppScenario::class); + McpContext::setLoginUserId(1); + + [$added] = $this->callMcpTool('addPage', [ + 'title' => '編集前', + 'name' => 'before-edit', + 'content' => '編集前の本文
', + ]); + + [$result, $isError] = $this->callMcpTool('editPage', [ + 'id' => $added['id'], + 'title' => '編集後', + 'content' => '編集後の本文
', + ]); + + $this->assertFalse($isError, 'ツールの実行に失敗しました。' . (is_string($result)? $result : json_encode($result, JSON_UNESCAPED_UNICODE))); + $this->assertEquals('編集後', $result['content']['title']); + $this->assertEquals('編集後の本文
', $result['contents']); + // 指定しなかった項目は変更されない + $this->assertEquals('before-edit', $result['content']['name']); + } + + /** + * test getPages と getPage で固定ページを取得できる + */ + public function testGetPages() + { + $this->loadFixtureScenario(InitAppScenario::class); + McpContext::setLoginUserId(1); + + [$added] = $this->callMcpTool('addPage', [ + 'title' => '取得テスト', + 'name' => 'get-test', + 'content' => '取得テストの本文
', + ]); + + [$list, $listError] = $this->callMcpTool('getPages', ['limit' => 10]); + $this->assertFalse($listError, is_string($list)? $list : json_encode($list, JSON_UNESCAPED_UNICODE)); + $this->assertNotEmpty($list); + + [$single, $singleError] = $this->callMcpTool('getPage', ['id' => $added['id']]); + $this->assertFalse($singleError, is_string($single)? $single : json_encode($single, JSON_UNESCAPED_UNICODE)); + $this->assertEquals('取得テスト', $single['content']['title']); + } + + /** + * test deletePage で固定ページが削除できる + */ + public function testDeletePage() + { + $this->loadFixtureScenario(InitAppScenario::class); + McpContext::setLoginUserId(1); + + [$added] = $this->callMcpTool('addPage', [ + 'title' => '削除対象', + 'name' => 'to-be-deleted', + 'content' => '削除対象の本文
', + ]); + + [$result, $isError] = $this->callMcpTool('deletePage', ['id' => $added['id']]); + $this->assertFalse($isError, is_string($result)? $result : json_encode($result, JSON_UNESCAPED_UNICODE)); + + [$notFound, $notFoundError] = $this->callMcpTool('getPage', ['id' => $added['id']]); + $this->assertTrue($notFoundError, '削除したページが取得できてしまいました。'); + } + + /** + * test 権限チェック用のURL + */ + public function testGetPermissionUrl() + { + $this->assertEquals( + ['POST' => '/baser-core/pages/add.json'], + PagesTool::getPermissionUrl('addPage') + ); + $this->assertEquals( + ['POST' => '/baser-core/pages/edit/3.json'], + PagesTool::getPermissionUrl('editPage', ['id' => 3]) + ); + $this->assertEquals( + ['GET' => '/baser-core/pages/index.json'], + PagesTool::getPermissionUrl('getPages') + ); + // id が無い編集・削除は権限チェックの対象にできない + $this->assertFalse(PagesTool::getPermissionUrl('editPage')); + } + +} +``` + +- [ ] **Step 2: テストを実行して失敗を確認する** + +Run: `docker exec basercms sh -c 'cd /var/www/html && vendor/bin/phpunit --no-coverage plugins/bc-mcp/tests/TestCase/Mcp/BaserCore/PagesToolTest.php 2>&1 | tail -20'` + +Expected: FAIL（`BcMcp\Mcp\BaserCore\PagesTool` が存在しない）。 + +- [ ] **Step 3: `PagesTool` を実装する** + +Create: `plugins/bc-mcp/src/Mcp/BaserCore/PagesTool.php` + +既存の `BlogPostsTool` の構成（`registerTools()` → `getPermissionUrl()` → 各アクションメソッド）を踏襲する。`executeWithErrorHandling()` / `createSuccessResponse()` / `resolveLoginUserId()` は `BaseMcpTool` のものを使う。 + +`inputSchema` は次のとおり（`loginUserId` は公開しない）。 + +```php + /** + * 固定ページ関連のツールをサーバーに登録する + * + * @param \Mcp\Server\McpServer $server SDK のサーバー + * @return \Mcp\Server\McpServer + */ + public function registerTools(\Mcp\Server\McpServer $server): \Mcp\Server\McpServer + { + return $server + ->tool( + name: 'getPages', + description: '固定ページの一覧を取得します', + callback: [$this, 'getPages'], + inputSchema: [ + 'type' => 'object', + 'properties' => [ + 'keyword' => ['type' => 'string', 'description' => '検索キーワード（本文を対象に検索）'], + 'siteId' => ['type' => 'number', 'description' => 'サイトID（省略時は全て）'], + 'status' => ['type' => 'number', 'description' => '公開ステータス（0: 非公開, 1: 公開）（省略時は全て）'], + 'limit' => ['type' => 'number', 'description' => '取得件数（省略時は10件）'], + 'page' => ['type' => 'number', 'description' => 'ページ番号（省略時は1ページ目）'], + ] + ] + ) + ->tool( + name: 'getPage', + description: '指定されたIDの固定ページを取得します', + callback: [$this, 'getPage'], + inputSchema: [ + 'type' => 'object', + 'properties' => [ + 'id' => ['type' => 'number', 'description' => '固定ページID（必須）'], + ], + 'required' => ['id'] + ] + ) + ->tool( + name: 'addPage', + description: '固定ページを追加します', + callback: [$this, 'addPage'], + inputSchema: [ + 'type' => 'object', + 'properties' => [ + 'title' => ['type' => 'string', 'description' => 'ページタイトル（必須）'], + 'content' => ['type' => 'string', 'description' => 'ページ本文、マークダウン不可、HTML推奨'], + 'name' => ['type' => 'string', 'description' => 'URLのスラッグ（省略時は自動採番）'], + 'parentId' => ['type' => 'number', 'description' => '親フォルダのコンテンツID（省略時はサイトルート）'], + 'siteId' => ['type' => 'number', 'description' => 'サイトID（省略時は1）'], + 'status' => ['type' => 'number', 'description' => '公開ステータス（0: 非公開, 1: 公開）（省略時は0）'], + 'description' => ['type' => 'string', 'description' => 'ページの説明'], + 'publishBegin' => ['type' => 'string', 'format' => 'date-time', 'description' => '公開開始日時（省略時はなし）'], + 'publishEnd' => ['type' => 'string', 'format' => 'date-time', 'description' => '公開終了日時（省略時はなし）'], + 'pageTemplate' => ['type' => 'string', 'description' => 'ページテンプレート名（省略時はデフォルト）'], + 'eyeCatch' => ['type' => 'string', 'description' => 'アイキャッチ画像。外部画像URLを直接指定'], + ], + 'required' => ['title'] + ] + ) + ->tool( + name: 'editPage', + description: '固定ページを編集します', + callback: [$this, 'editPage'], + inputSchema: [ + 'type' => 'object', + 'properties' => [ + 'id' => ['type' => 'number', 'description' => '固定ページID（必須）'], + 'title' => ['type' => 'string', 'description' => 'ページタイトル'], + 'content' => ['type' => 'string', 'description' => 'ページ本文、マークダウン不可、HTML推奨'], + 'name' => ['type' => 'string', 'description' => 'URLのスラッグ'], + 'parentId' => ['type' => 'number', 'description' => '親フォルダのコンテンツID'], + 'status' => ['type' => 'number', 'description' => '公開ステータス（0: 非公開, 1: 公開）'], + 'description' => ['type' => 'string', 'description' => 'ページの説明'], + 'publishBegin' => ['type' => 'string', 'format' => 'date-time', 'description' => '公開開始日時'], + 'publishEnd' => ['type' => 'string', 'format' => 'date-time', 'description' => '公開終了日時'], + 'pageTemplate' => ['type' => 'string', 'description' => 'ページテンプレート名'], + 'eyeCatch' => ['type' => 'string', 'description' => 'アイキャッチ画像。外部画像URLを直接指定'], + ], + 'required' => ['id'] + ] + ) + ->tool( + name: 'deletePage', + description: '固定ページを削除します', + callback: [$this, 'deletePage'], + inputSchema: [ + 'type' => 'object', + 'properties' => [ + 'id' => ['type' => 'number', 'description' => '固定ページID（必須）'], + ], + 'required' => ['id'] + ] + ); + } +``` + +`getPermissionUrl()` は次のとおり。 + +```php + /** + * 権限チェック用のURLを取得する + * + * @param string $action アクション名 + * @param array $args 引数 + * @return array|false + */ + public static function getPermissionUrl($action, $args = []) + { + switch ($action) { + case 'addPage': + return ['POST' => '/baser-core/pages/add.json']; + case 'editPage': + if (empty($args['id'])) return false; + return ['POST' => "/baser-core/pages/edit/{$args['id']}.json"]; + case 'deletePage': + if (empty($args['id'])) return false; + return ['POST' => "/baser-core/pages/delete/{$args['id']}.json"]; + case 'getPages': + return ['GET' => '/baser-core/pages/index.json']; + case 'getPage': + if (empty($args['id'])) return false; + return ['GET' => "/baser-core/pages/view/{$args['id']}.json"]; + default: + return false; + } + } +``` + +`addPage()` はフラットな引数を `PagesService::create()` の入れ子構造へ組み立てる。**引数の `$content`（本文）と保存先の `content`（コンテンツ情報）の対応関係をコメントで明示する。** + +```php + /** + * 固定ページを追加する + * + * 固定ページは pages テーブルと contents テーブルの複合構造である点に注意する。 + * 引数の $content（ページ本文）は pages.contents へ、タイトルや URL などは + * content キー（Contents アソシエーション）へ格納する。 + * + * @param string $title ページタイトル + * @param string|null $content ページ本文 + * @param string|null $name URLのスラッグ + * @param int|null $parentId 親フォルダのコンテンツID + * @param int|null $siteId サイトID + * @param int|null $status 公開ステータス + * @param string|null $description 説明 + * @param string|null $publishBegin 公開開始日時 + * @param string|null $publishEnd 公開終了日時 + * @param string|null $pageTemplate ページテンプレート + * @param string|null $eyeCatch アイキャッチ画像 + * @param int|null $loginUserId ログインユーザーID + * @return array + */ + public function addPage( + string $title, + ?string $content = null, + ?string $name = null, + ?int $parentId = null, + ?int $siteId = null, + ?int $status = 0, + ?string $description = null, + ?string $publishBegin = null, + ?string $publishEnd = null, + ?string $pageTemplate = null, + ?string $eyeCatch = null, + ?int $loginUserId = null + ): array + { + return $this->executeWithErrorHandling(function() use ( + $title, $content, $name, $parentId, $siteId, $status, + $description, $publishBegin, $publishEnd, $pageTemplate, $eyeCatch, $loginUserId + ) { + /** @var \BaserCore\Service\PagesService $pagesService */ + $pagesService = $this->getService(PagesServiceInterface::class); + + $contentData = [ + 'title' => $title, + 'plugin' => 'BaserCore', + 'type' => 'Page', + 'site_id' => $siteId ?? 1, + 'parent_id' => $parentId ?? $this->getSiteRootContentId($siteId ?? 1), + 'self_status' => (bool)$status, + ]; + if ($name !== null) $contentData['name'] = $name; + if ($description !== null) $contentData['description'] = $description; + if ($publishBegin !== null) $contentData['publish_begin'] = $publishBegin; + if ($publishEnd !== null) $contentData['publish_end'] = $publishEnd; + if ($eyeCatch !== null) $contentData['eyecatch'] = $this->processImageUpload($eyeCatch); + + $postData = [ + // ページ本文は pages.contents + 'contents' => $content ?? '', + 'content' => $contentData, + ]; + if ($pageTemplate !== null) $postData['page_template'] = $pageTemplate; + + $page = $pagesService->create($postData); + + return $this->createSuccessResponse( + $page->toArray(), + [], + '固定ページ「' . $title . '」を追加しました。', + $this->resolveLoginUserId($loginUserId) + ); + }); + } +``` + +`getSiteRootContentId()` は親フォルダ未指定時にサイトルートのコンテンツIDを引くためのヘルパ。`ContentsService` または `Contents` テーブルの `site_root` フラグから取得する。取得方法は `baser-core` の `ContentsTable`／`ContentFoldersService` を確認して決める。 + +Run: `docker exec basercms sh -c 'cd /var/www/html && grep -rn "site_root" plugins/baser-core/src/Model/Table/ContentsTable.php | head -5'` + +`editPage()` は `PagesService::get()` で対象を取得し、指定された項目のみを差分で `update()` に渡す。`deletePage()` は `PagesService::delete()` を呼ぶ。`getPages()` は `getIndex()`、`getPage()` は `get()` を使い、いずれも `content` を含めて返す（`contain` の指定が必要か確認する）。 + +- [ ] **Step 4: `BaserCoreServer` にツールクラスを登録する** + +Modify: `plugins/bc-mcp/src/Mcp/BaserCore/BaserCoreServer.php` + +`getToolClasses()` の配列に `PagesTool::class` を追加する。 + +- [ ] **Step 5: 構文チェック** + +Run: `docker exec basercms sh -c 'cd /var/www/html && php -l plugins/bc-mcp/src/Mcp/BaserCore/PagesTool.php && php -l plugins/bc-mcp/src/Mcp/BaserCore/BaserCoreServer.php'` + +Expected: `No syntax errors detected`。 + +- [ ] **Step 6: テストを実行して通ることを確認する** + +Run: `docker exec basercms sh -c 'cd /var/www/html && vendor/bin/phpunit --no-coverage plugins/bc-mcp/tests/TestCase/Mcp/BaserCore/PagesToolTest.php 2>&1 | tail -30'` + +Expected: PASS（5テスト）。 + +- [ ] **Step 7: tools/list に固定ページツールが並ぶことを確認する** + +Modify: `plugins/bc-mcp/tests/TestCase/Mcp/McpServerTest.php` + +`testToolsListContainsAllTools()` に assertion を追加する。 + +```php + // BaserCore（固定ページ） + $this->assertContains('getPages', $names); + $this->assertContains('getPage', $names); + $this->assertContains('addPage', $names); + $this->assertContains('editPage', $names); + $this->assertContains('deletePage', $names); +``` + +Run: `docker exec basercms sh -c 'cd /var/www/html && vendor/bin/phpunit --no-coverage plugins/bc-mcp/tests/TestCase/Mcp/McpServerTest.php 2>&1 | tail -20'` + +Expected: PASS。 + +- [ ] **Step 8: プラグイン全体のテストを実行する** + +Run: `docker exec basercms sh -c 'cd /var/www/html && vendor/bin/phpunit --no-coverage --testsuite BcMcp 2>&1 | tail -30'` + +Expected: PASS。 + +- [ ] **Step 9: コミット** + +```bash +git add plugins/bc-mcp/src/Mcp/BaserCore/PagesTool.php plugins/bc-mcp/src/Mcp/BaserCore/BaserCoreServer.php plugins/bc-mcp/tests/TestCase/Mcp/BaserCore/PagesToolTest.php plugins/bc-mcp/tests/TestCase/Mcp/McpServerTest.php +git commit -m "固定ページの取得・作成・編集・削除ツールを追加" +``` diff --git a/docs/superpowers/plans/2026-08-17-bc-mcp-scope.md b/docs/superpowers/plans/2026-08-17-bc-mcp-scope.md new file mode 100644 index 0000000000..339b20b157 --- /dev/null +++ b/docs/superpowers/plans/2026-08-17-bc-mcp-scope.md @@ -0,0 +1,1085 @@ +# bc-mcp スコープ整理 実装計画 + +> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. + +**Goal:** bc-mcp を「運営者向けの認証付き MCP サーバー」として定義し直し、スコープ外のコード（`search` / `fetch`、チャンクアップロード、stdio 経路）を削除したうえで、全ツールにツール注釈を宣言する。 + +**Architecture:** 既存の SDK ベース構成（`McpServer` がツールクラスを集めて登録、`McpProxyController` が認証と権限を担い `McpRequestHandler` がプロセス内で実行）は変えない。変更は「登録するツールの取捨選択」「`tool()` へ渡す注釈」「認証を通らない経路の削除」の3点に閉じる。 + +**Tech Stack:** PHP 8.1+ / CakePHP 5.2 / baserCMS 5.4 / logiscape/mcp-sdk-php v2 / PHPUnit 10.5 + +**Spec:** [docs/superpowers/specs/2026-08-17-bc-mcp-scope-design.md](../specs/2026-08-17-bc-mcp-scope-design.md) + +## Global Constraints + +- **実行環境**: ユニットテストは必ず Docker コンテナ `basercms` 上で実行する。baserCMS の配置先は `/var/www/html`。 +- **テストコマンドの雛形**: `docker exec basercms bash -c "cd /var/www/html && vendor/bin/phpunit --no-coverage <対象>"` +- **フルスイートと個別テストを並行実行しない**（テスト DB が競合する）。 +- **公開ツール数は51のまま変えない。** 本計画で削除するのは、いずれも `BaserCoreServer::getToolClasses()` に登録されていないコードである。 +- **コメント・説明は日本語で書く。** 既存コードのコメント密度と語り口に合わせる。 +- **権限チェックは Admin Web API に委ねる**（原則2）。独自の権限判定を追加しない。 +- 対象ブランチは `dev-agentic`。 + +--- + +## File Structure + +| ファイル | 役割 | 変更 | +|---|---|---| +| `plugins/bc-mcp/src/Mcp/BaseMcpTool.php` | 全ツールの基底。注釈定数の置き場 | 定数追加、`processChunkFile()` 削除、コメント修正 | +| `plugins/bc-mcp/src/Mcp/BaserCore/BaserCoreServer.php` | BaserCore のツールクラス一覧 | コメントアウト行の削除 | +| `plugins/bc-mcp/src/Mcp/BaserCore/SearchIndexesTool.php` | `search` / `fetch` | **削除** | +| `plugins/bc-mcp/src/Mcp/BaserCore/FileUploadTool.php` | `sendFileChunk` | **削除** | +| `plugins/bc-mcp/src/Command/McpServerCommand.php` | stdio 起動コマンド | **削除** | +| `plugins/bc-mcp/src/BcMcpPlugin.php` | プラグイン定義 | `console()` の削除 | +| `plugins/bc-mcp/src/Mcp/McpServer.php` | サーバー組み立てと `serverInfo` | `runStdio()` 削除、`available_transports` 修正、`serverInfo` に注釈 | +| `plugins/bc-mcp/src/Mcp/**/*Tool.php`（11ファイル） | 各ツールの登録 | `tool()` に `annotations:` を追加（計50件） | +| `plugins/bc-mcp/src/Mcp/BcCustomContent/CustomEntriesTool.php` | カスタムエントリー | 上記に加え `keyword` を公開 | +| `plugins/bc-mcp/tests/TestCase/Mcp/AnnotationsTest.php` | 注釈の全数検証 | **新規作成** | +| `plugins/bc-mcp/README.md` | 利用者向け文書 | アップロードと Cloudflare の節を更新 | + +タスクの並びは「削除 → 注釈 → 補完 → 文書」の順とする。削除を先に済ませることで、注釈を付けて回る対象が確定する。 + +--- + +## Task 1: stdio トランスポートの削除 + +認証・権限・Origin 検証のいずれも通らない経路を塞ぐ。設計書 3.2 に対応。 + +**Files:** +- Delete: `plugins/bc-mcp/src/Command/McpServerCommand.php` +- Delete: `plugins/bc-mcp/tests/TestCase/Command/McpServerCommandTest.php` +- Modify: `plugins/bc-mcp/src/BcMcpPlugin.php`（`console()` メソッド） +- Modify: `plugins/bc-mcp/src/Mcp/McpServer.php`（`runStdio()` と `available_transports`） +- Modify: `plugins/bc-mcp/src/Mcp/BaseMcpTool.php`（`resolveLoginUserId()` の docblock） +- Test: `plugins/bc-mcp/tests/TestCase/Mcp/McpServerTest.php` + +**Interfaces:** +- Consumes: なし（最初のタスク） +- Produces: `McpServer` から `runStdio()` が消える。以降のタスクは `McpServer::getServer()` と `McpRequestHandler` のみを使う。 + +- [ ] **Step 1: `available_transports` の期待値を変えるテストを書く** + +`plugins/bc-mcp/tests/TestCase/Mcp/McpServerTest.php` に既存の `serverInfo` 検証があれば修正し、無ければ以下を追加する。 + +```php + /** + * test serverInfo が提供するトランスポートは HTTP のみ + * + * 認証と権限を通らない stdio 経路は提供しない + */ + public function testServerInfoReportsHttpOnly() + { + $result = (new McpServer())->serverInfo(); + + $this->assertEquals(['http'], $result['available_transports']); + } +``` + +- [ ] **Step 2: テストを実行して失敗を確認する** + +```bash +docker exec basercms bash -c "cd /var/www/html && vendor/bin/phpunit --no-coverage --filter testServerInfoReportsHttpOnly plugins/bc-mcp/tests/TestCase/Mcp/McpServerTest.php" +``` + +期待: FAIL（`['stdio', 'http']` が返るため差分で落ちる） + +- [ ] **Step 3: `McpServer` から stdio を取り除く** + +`plugins/bc-mcp/src/Mcp/McpServer.php` の `runStdio()` メソッド全体（docblock を含む）を削除する。 + +```php + /** + * 標準入力からサーバーを起動する + * + * HTTP 経由の利用は /bc-mcp エンドポイントが担うため、常駐プロセスとしての + * 起動は標準入出力のみを提供する。 + * + * @return void + */ + public function runStdio(): void + { + $this->server->runStdio(); + } +``` + +続いて `serverInfo()` 内の記述を変更する。 + +変更前: +```php + 'available_transports' => ['stdio', 'http'], +``` + +変更後: +```php + 'available_transports' => ['http'], +``` + +- [ ] **Step 4: テストを実行して成功を確認する** + +```bash +docker exec basercms bash -c "cd /var/www/html && vendor/bin/phpunit --no-coverage --filter testServerInfoReportsHttpOnly plugins/bc-mcp/tests/TestCase/Mcp/McpServerTest.php" +``` + +期待: PASS + +- [ ] **Step 5: コマンドとそのテストを削除する** + +```bash +git rm plugins/bc-mcp/src/Command/McpServerCommand.php +git rm plugins/bc-mcp/tests/TestCase/Command/McpServerCommandTest.php +``` + +- [ ] **Step 6: プラグインからコマンド登録を外す** + +`plugins/bc-mcp/src/BcMcpPlugin.php` の `console()` メソッド全体を削除する。`Oauth2CleanupCommand` は CakePHP の自動探索で読み込まれるため、明示登録は不要になる。 + +削除する部分: +```php + /** + * Add commands for the plugin. + * + * @param \Cake\Console\CommandCollection $commands The command collection to update. + * @return \Cake\Console\CommandCollection + */ + public function console(CommandCollection $commands): CommandCollection + { + // MCPサーバーコマンドを追加 + $commands->add('bc_mcp.server', \BcMcp\Command\McpServerCommand::class); + $commands = parent::console($commands); + return $commands; + } +``` + +あわせて未使用になる `use Cake\Console\CommandCollection;` も削除する。 + +- [ ] **Step 7: 残った stdio への言及を直す** + +`plugins/bc-mcp/src/Mcp/BaseMcpTool.php` の `resolveLoginUserId()` の docblock を修正する。 + +変更前: +```php + * MCP のツールは JSON-RPC の引数しか受け取らないため、認証済みの操作者は + * McpContext から取得する。引数で明示された場合はそれを優先する + * （stdio 経由の利用など、コンテキストを持たない経路のため）。 +``` + +変更後: +```php + * MCP のツールは JSON-RPC の引数しか受け取らないため、認証済みの操作者は + * McpContext から取得する。引数で明示された場合はそれを優先する + * （テストなど、コンテキストを持たない経路のため）。 +``` + +- [ ] **Step 8: `Oauth2CleanupCommand` が消えていないことを確認する** + +```bash +docker exec basercms bash -c "cd /var/www/html && bin/cake" 2>&1 | grep -c "bc_mcp" +``` + +期待: `1`（`bc_mcp.oauth2_cleanup` のみが残り、`bc_mcp.server` は消えている） + +実際のコマンド名が異なる場合は、`bin/cake` の出力を確認して `bc_mcp` で始まる行が `server` を含まないことを目視で確認する。 + +- [ ] **Step 9: bc-mcp のテストを通す** + +```bash +docker exec basercms bash -c "cd /var/www/html && vendor/bin/phpunit --no-coverage plugins/bc-mcp/tests" +``` + +期待: PASS（削除したコマンドのテスト分だけ件数が減る） + +- [ ] **Step 10: コミット** + +```bash +git add -A plugins/bc-mcp +git commit -m "認証と権限を通らない stdio 経路を削除 + +PermissionManager を呼ぶのは McpProxyController のみで、bin/cake +bc_mcp.server は OAuth 認証・権限チェック・Origin 検証・ログイン +ユーザーの設定を全て素通りしていた。 + +管理画面のツール一覧は McpRequestHandler をプロセス内で呼ぶため +影響を受けない。 + +Co-Authored-By: Claude Opus 5 (1M context)本文
', + 'page_template' => '', + 'content' => [ + 'title' => 'ページタイトル', + 'name' => 'about', + 'parent_id' => 1, + 'site_id' => 1, + 'plugin' => 'BaserCore', + 'type' => 'Page', + 'self_status' => true, + ], +] +``` + +`plugin` は `'BaserCore'`、`type` は `'Page'` の固定値であり、ツール側で自動的に補う（AI クライアントに指定させない）。 + +### 12.2 提供するツール + +`src/Mcp/BaserCore/PagesTool.php` を新規作成し、`BaserCoreServer::getToolClasses()` に登録する。 + +| ツール | 対応するサービス | 権限チェック用 URL | +|---|---|---| +| `getPages` | `PagesService::getIndex()` | `GET /baser-core/pages/index.json` | +| `getPage` | `PagesService::get()` | `GET /baser-core/pages/view/{id}.json` | +| `addPage` | `PagesService::create()` | `POST /baser-core/pages/add.json` | +| `editPage` | `PagesService::update()` | `POST /baser-core/pages/edit/{id}.json` | +| `deletePage` | `PagesService::delete()` | `POST /baser-core/pages/delete/{id}.json` | + +### 12.3 引数設計 + +既存ツールと同様に、AI クライアントが扱いやすいフラットな引数にし、内部で上記の入れ子構造へ組み立てる。 + +`addPage` の引数。 + +| 引数 | 対応先 | 説明 | +|---|---|---| +| `title`（必須） | `content.title` | ページタイトル | +| `content` | `pages.contents` | ページ本文（HTML） | +| `name` | `content.name` | URL のスラッグ（省略時は baserCMS が自動採番） | +| `parentId` | `content.parent_id` | 親フォルダのコンテンツID（省略時はサイトルート） | +| `siteId` | `content.site_id` | サイトID（省略時は 1） | +| `status` | `content.self_status` | 公開状態（0: 非公開, 1: 公開。省略時は 0） | +| `description` | `content.description` | 説明 | +| `publishBegin` / `publishEnd` | `content.publish_begin` / `publish_end` | 公開期間 | +| `pageTemplate` | `pages.page_template` | ページテンプレート | +| `eyeCatch` | `content.eyecatch` | アイキャッチ画像（外部画像 URL を直接指定） | + +引数名の `content`（本文）と保存先の `content`（コンテンツ情報）が紛らわしいため、**実装時のコメントで対応関係を明示する**。 + +`editPage` は `id`（必須）＋上記の任意項目。`deletePage` は `id` のみ。`getPages` は `keyword` / `siteId` / `status` / `limit` / `page`。`getPage` は `id`。 + +**`loginUserId` は `inputSchema` に公開せず、`McpContext` から取得する**（他ツールと同じ方針）。 + +**サイトの指定は必須情報として扱う。** 固定ページは Content が必須で、Content にはサイトの指定が必須である（`ContentsTable` の `site_id` は `notEmptyString`）。したがって「どのサイトに作るのか」は必ず必要な情報であり、ID を決め打ちしない。`siteId` が省略された場合は `SitesTable::getRootMain()` でメインサイトを解決し、解決できなければエラーを返す。`parentId` も同様に、省略時は指定されたサイトのルートを解決する。 + +### 12.4 実装で判明した baserCMS の作法（2026-08-12 実測） + +固定ページの保存はコンテンツ管理の仕組みと深く絡んでおり、ブログ記事より前提が多い。実装時に判明した点を記録する。 + +| 事象 | 原因と対処 | +|---|---| +| `Record not found in table 'sites'` で保存に失敗する | **真因はテストDBに残っていた前回実行のデータ**だった。`InitAppScenario` の `SiteFactory` が一意制約に衝突して失敗し、`sites` が空のまま `PagesTable::createSearchIndex()` の `$this->Sites->get($content->site_id)` が走ったため。当初「ログイン状態が必要」と記述したが、**実験（ログインなし・Router のリクエストなしでも成功）により誤りと確認した**。なお固定ページは保存中の Content エンティティから `Sites->get()` を呼ぶ一方、ブログ記事は `blog_content_id` から既存の Content を引くだけで `Sites->get()` を呼ばないため、この経路の問題は固定ページ固有である | +| `Node '1' was not found in the tree.` | `ContentFactory` で作ったノードは `lft` / `rght` が整合しない。`RootContentScenario` を読んだ後に **`Contents->recover()`** でツリーを再構築する必要がある（`MultiSiteScenario` も同じことをしている） | +| 追加したページが `getPages` の一覧に出てこない | `PagesService::createIndexConditions()` が検索値を検査せずキーの存在だけで LIKE 条件を付けており、`getIndex()` の既定値 `draft => null` により常に `draft LIKE '%%'` が付いていた。SQL の `NULL LIKE '%%'` が偽となるため `draft` が NULL の行が必ず除外される。**baser-core 側のバグとして 5.4.x で修正済み**（回帰テストも追加）。bc-mcp 側の回避策（`draft` を空文字で保存）は不要になったため削除した | +| `deletePage` の挙動 | **解決。** `PagesService::delete()` は**完全削除**であり、`pages` と紐づく `contents` のレコードがいずれも消える（`withDeleted` を付けてもゴミ箱に残らない）。`baser-core` の `PagesServiceTest::testDelete()` が期待する挙動と一致する。当初「ゴミ箱へ移動」と想定したのは誤りだった | +| テスト間で一意制約に衝突する（`Duplicate entry '1' for key 'users.PRIMARY'`） | **解決。** 真因は**テストDBに前回実行の残骸が溜まっていたこと**であり、fixture 戦略の限界ではなかった。DB を掃除し vendor を `composer.lock` に揃えた環境では発生しない。念のため `setUp()` で `BcTestCase::truncateTable()` を呼び、関係テーブルを明示的に空にしている | +| エラーが MCP の `isError` にならない | `BaseMcpTool::executeWithErrorHandling()` が例外を捕まえて `createErrorResponse()` の戻り値（`content` キーにメッセージ）として返すため、SDK レベルでは正常な戻り値になる。**移植前からの設計**であり本移植では変更していないが、AI クライアントがエラーを検知しにくいという課題は残る | + +なお `BcTestCase::setFixtureTruncate()` は宣言のみで実際に `FixtureStrategy` を切り替えるコードが存在せず機能していなかった（旧 Fixture から FixtureFactory への移行期間中の残骸）。**5.4.x で削除済み**。 + +## 13. 完了条件と達成状況（2026-08-13 確認） + +| 条件 | 状況 | 根拠 | +|---|---|---| +| Modern（`2026-07-28`）と Legacy の両世代で `tools/list` → `tools/call` が通る | **達成** | `DualEraTest`（6 tests）。Legacy は `initialize` → セッションID → `tools/call` の正規フローを検証 | +| 常駐プロセスを起動しなくても `/bc-mcp` が応答する | **達成** | `McpProxyControllerTest` / `OAuth2ControllerTest`（統合テストから常駐サーバー起動処理を削除して通過） | +| 既存の bc-mcp テストがすべて通り、フルスイートに回帰がない | **達成** | bc-mcp: 218 tests / 1011 assertions。フルスイート: **4810 tests / 10544 assertions、失敗・エラー 0 件**（CakePHP 5.2.15 環境で検証。Skipped 2 / Incomplete 440 はいずれも移植前から存在する既存の状態） | +| `logs/mcp.log` から接続クライアントの世代とプロトコルバージョンが判別できる | **達成** | `NegotiationLoggerTest`（8 tests）。実ログでも確認（`era=modern protocolVersion=2026-07-28 client=…`） | +| 許可外 `Origin` からのリクエストが 403 で拒否される | **達成** | `McpProxyControllerTest` | +| 認可レスポンスに `iss` が含まれ、メタデータの `issuer` と一致する | **達成** | `OAuth2UtilTest` および `OAuth2ControllerTest`（実際の認可フローで一致を検証） | +| `vendor/php-mcp` への依存が残っていない | **達成** | `composer.json` / ソース全体の grep で参照ゼロ | +| `McpServerManger` と管理画面の起動/停止 UI が削除されている | **達成** | ファイル削除・ルート削除。grep で参照ゼロ | +| 固定ページの取得・作成・編集・削除がツールとして提供される | **達成** | `PagesToolTest`（6 tests / 32 assertions）。`tools/list` に5ツールが並ぶ事も `McpServerTest` で検証 | + +### 補足: stdio 起動の確認 + +`bin/cake bc_mcp.server` はこの開発環境では**コマンドとして登録されない**。BcMcp が `defaultInstallCorePlugins` に含まれず有効化されていないためで、**移植前から同じ状態**である（移植前の `OAuth2ControllerTest` にも同じ事情のコメントが残っていた）。`McpServer` 自体はプロセス内実行の各テストで動作を確認済み。stdio 経路の実起動確認はプラグインを有効化した環境で別途行う。 diff --git a/docs/superpowers/specs/2026-08-12-mcp-2026-07-28-bc-mcp-impact.md b/docs/superpowers/specs/2026-08-12-mcp-2026-07-28-bc-mcp-impact.md new file mode 100644 index 0000000000..161543d7d8 --- /dev/null +++ b/docs/superpowers/specs/2026-08-12-mcp-2026-07-28-bc-mcp-impact.md @@ -0,0 +1,235 @@ +# MCP 仕様 2026-07-28 の bc-mcp への影響調査 + +- 調査日: 2026-08-12 +- 対象: `plugins/bc-mcp`（BcMcp / baserCMS コアプラグイン） +- 結論: **今回は対応を行わない。本ドキュメントを記録として残し、Claude が Modern 世代へ切り替わった時点で改めて着手する。** + +## 1. 調査の背景 + +2026-07-28、MCP（Model Context Protocol）の新リビジョン `2026-07-28` が最終仕様として公開され、Anthropic から Claude 各製品への展開が告知された。 + +- Anthropic 告知:最新の と、それ以前の世代（initialize 方式）の両方に対応しています。
+| 日時 | +世代 | +プロトコルバージョン | +クライアント | +メソッド | +
|---|---|---|---|---|
| + | + | + | + + + () + + | ++ |
クライアントが新しい世代（）へ切り替わったかどうかを、ここで確認できます。
+ +まだ接続がありません。
+ + +| ツール名 | +説明 | +
|---|---|
|
+ + |
利用可能なツールがありません。
+ + +会社概要のページです。
', + 'status' => 1, + ]); + + $this->assertFalse($isError, 'ツールの実行に失敗しました。' . (is_string($result)? $result : json_encode($result, JSON_UNESCAPED_UNICODE))); + $this->assertArrayHasKey('id', $result, json_encode($result, JSON_UNESCAPED_UNICODE)); + // 本文は pages.contents に保存される + $this->assertEquals('会社概要のページです。
', $result['contents']); + // タイトルと URL はコンテンツ情報に保存される + $this->assertEquals('会社概要', $result['content']['title']); + $this->assertEquals('about', $result['content']['name']); + // plugin と type はツール側で補われる + $this->assertEquals('BaserCore', $result['content']['plugin']); + $this->assertEquals('Page', $result['content']['type']); + $this->assertTrue((bool)$result['content']['self_status']); + } + + /** + * test editPage で固定ページが編集できる + */ + public function testEditPage() + { + [$added] = $this->callMcpTool('addPage', [ + 'title' => '編集前', + 'name' => 'before-edit', + 'content' => '編集前の本文
', + ]); + + [$result, $isError] = $this->callMcpTool('editPage', [ + 'id' => $added['id'], + 'title' => '編集後', + 'content' => '編集後の本文
', + ]); + + $this->assertFalse($isError, 'ツールの実行に失敗しました。' . (is_string($result)? $result : json_encode($result, JSON_UNESCAPED_UNICODE))); + $this->assertEquals('編集後', $result['content']['title']); + $this->assertEquals('編集後の本文
', $result['contents']); + // 指定しなかった項目は変更されない + $this->assertEquals('before-edit', $result['content']['name']); + } + + /** + * test getPages と getPage で固定ページを取得できる + */ + public function testGetPages() + { + [$added] = $this->callMcpTool('addPage', [ + 'title' => '取得テスト', + 'name' => 'get-test', + 'content' => '取得テストの本文
', + ]); + + [$list, $listError] = $this->callMcpTool('getPages', ['limit' => 10]); + $this->assertFalse($listError, is_string($list)? $list : json_encode($list, JSON_UNESCAPED_UNICODE)); + // 他の一覧系ツールと同じ data / pagination 形式で返る + $this->assertNotEmpty($list['data']); + $this->assertEquals(1, $list['pagination']['page']); + $this->assertEquals(10, $list['pagination']['limit']); + $this->assertEquals(count($list['data']), $list['pagination']['count']); + + [$single, $singleError] = $this->callMcpTool('getPage', ['id' => $added['id']]); + $this->assertFalse($singleError, is_string($single)? $single : json_encode($single, JSON_UNESCAPED_UNICODE)); + $this->assertEquals('取得テスト', $single['content']['title']); + $this->assertEquals('取得テストの本文
', $single['contents']); + } + + /** + * test getPages はキーワードで本文を検索できる + */ + public function testGetPagesWithKeyword() + { + $this->callMcpTool('addPage', [ + 'title' => 'キーワード対象', + 'name' => 'keyword-target', + 'content' => '特別な検索語を含む本文
', + ]); + $this->callMcpTool('addPage', [ + 'title' => 'キーワード対象外', + 'name' => 'keyword-other', + 'content' => '関係のない本文
', + ]); + + [$list, $isError] = $this->callMcpTool('getPages', ['keyword' => '特別な検索語']); + + $this->assertFalse($isError, is_string($list)? $list : json_encode($list, JSON_UNESCAPED_UNICODE)); + $this->assertCount(1, $list['data']); + $this->assertEquals('キーワード対象', $list['data'][0]['content']['title']); + } + + /** + * test deletePage で固定ページが削除できる + * + * PagesService::delete() は完全削除であり、pages と contents の + * レコードがいずれも消える（ゴミ箱にも残らない） + */ + public function testDeletePage() + { + [$added] = $this->callMcpTool('addPage', [ + 'title' => '削除対象', + 'name' => 'to-be-deleted', + 'content' => '削除対象の本文
', + ]); + + [$result, $isError] = $this->callMcpTool('deletePage', ['id' => $added['id']]); + $this->assertFalse($isError, is_string($result)? $result : json_encode($result, JSON_UNESCAPED_UNICODE)); + $this->assertEquals('削除対象', $result['title']); + + // pages のレコードが消えている + $this->assertEquals(0, TableRegistry::getTableLocator()->get('BaserCore.Pages') + ->find()->where(['Pages.id' => $added['id']])->count()); + // 紐づく contents のレコードも消えている（ゴミ箱にも残らない） + $this->assertEquals(0, TableRegistry::getTableLocator()->get('BaserCore.Contents') + ->find() + ->where(['Contents.entity_id' => $added['id'], 'Contents.type' => 'Page']) + ->applyOptions(['withDeleted']) + ->count()); + // 削除済みのため取得できない。 + // BaseMcpTool::executeWithErrorHandling() が例外を戻り値へ包むため、 + // MCP レベルの isError にはならず content にエラーメッセージが入る + [$notFound] = $this->callMcpTool('getPage', ['id' => $added['id']]); + $this->assertStringContainsString( + 'Record not found', + $notFound['content'] ?? '', + '削除したページが取得できてしまいました。' . json_encode($notFound, JSON_UNESCAPED_UNICODE) + ); + } + + /** + * test siteId を省略した場合はメインサイトに作成される + * + * 固定ページは Content が必須で、Content にはサイトの指定が必須である。 + * 省略時は ID の決め打ちではなくメインサイトを解決する + */ + public function testAddPageResolvesMainSite() + { + $mainSiteId = TableRegistry::getTableLocator()->get('BaserCore.Sites')->getRootMain()->id; + + [$result, $isError] = $this->callMcpTool('addPage', [ + 'title' => 'サイト解決テスト', + 'name' => 'main-site-resolution', + 'content' => '本文
', + ]); + + $this->assertFalse($isError, is_string($result)? $result : json_encode($result, JSON_UNESCAPED_UNICODE)); + $this->assertEquals($mainSiteId, $result['content']['site_id']); + // 親フォルダはそのサイトのルートになる + $this->assertNotEmpty($result['content']['parent_id']); + } + + /** + * test siteId を明示した場合はそのサイトに作成される + */ + public function testAddPageWithExplicitSiteId() + { + [$result, $isError] = $this->callMcpTool('addPage', [ + 'title' => 'サイト指定テスト', + 'name' => 'explicit-site', + 'content' => '本文
', + 'siteId' => 1, + ]); + + $this->assertFalse($isError, is_string($result)? $result : json_encode($result, JSON_UNESCAPED_UNICODE)); + $this->assertEquals(1, $result['content']['site_id']); + } + + /** + * test 権限チェック用のURL + */ + public function testGetPermissionUrl() + { + $this->assertEquals( + ['POST' => '/baser-core/pages/add.json'], + PagesTool::getPermissionUrl('addPage') + ); + $this->assertEquals( + ['POST' => '/baser-core/pages/edit/3.json'], + PagesTool::getPermissionUrl('editPage', ['id' => 3]) + ); + $this->assertEquals( + ['POST' => '/baser-core/pages/delete/3.json'], + PagesTool::getPermissionUrl('deletePage', ['id' => 3]) + ); + $this->assertEquals( + ['GET' => '/baser-core/pages/index.json'], + PagesTool::getPermissionUrl('getPages') + ); + $this->assertEquals( + ['GET' => '/baser-core/pages/view/3.json'], + PagesTool::getPermissionUrl('getPage', ['id' => 3]) + ); + // id が無い編集・削除・取得は権限チェックの対象にできない + $this->assertFalse(PagesTool::getPermissionUrl('editPage')); + $this->assertFalse(PagesTool::getPermissionUrl('unknownAction')); + } + +} diff --git a/plugins/bc-mcp/tests/TestCase/Mcp/BcBlog/BlogCategoriesToolTest.php b/plugins/bc-mcp/tests/TestCase/Mcp/BcBlog/BlogCategoriesToolTest.php new file mode 100644 index 0000000000..7307da80ef --- /dev/null +++ b/plugins/bc-mcp/tests/TestCase/Mcp/BcBlog/BlogCategoriesToolTest.php @@ -0,0 +1,518 @@ + + * Copyright (c) NPO baser foundationBcMcpは、baserCMSを外部のAIエージェントから直接操作できるようにするMCP（Model Context Protocol）サーバーです。ブログ記事やカテゴリ、タグの管理はもちろん、カスタムテーブル・カスタムコンテンツ・カスタムエントリー・カスタムリンクといったbaserCMSの柔軟な拡張機能まで、AIアシスタント経由で読み書きできます。
', + 'detail' => $this->getDetail(), + ]); + + // ツール実行時に例外が発生していない事を確認 + $this->assertFalse($isError, 'ツールの実行に失敗しました。' . (is_string($result)? $result : json_encode($result, JSON_UNESCAPED_UNICODE))); + // ブログ記事が登録されている事を確認 + $this->assertArrayHasKey('id', $result, 'ブログ記事の登録に失敗しました。' . json_encode($result, JSON_UNESCAPED_UNICODE)); + $this->assertEquals('BcMcpについて', $result['title']); + $this->assertEquals('about-bcmcp', $result['name']); + $this->assertEquals(1, $result['blog_content_id']); + // McpContext 経由でログインユーザーが反映されている事を確認 + $this->assertEquals(1, $result['user_id']); + $this->assertFalse($result['status']); + } + + /** + * 本番環境で送信された記事詳細を取得する + * + * @return string + */ + private function getDetail(): string + { + return <<BcMcpは、baserCMSをAIエージェントから直接操作するためのMCP（Model Context Protocol）サーバーです。MCPは、AIアシスタントと外部システムを標準化された方法でつなぐプロトコルであり、BcMcpはこの仕組みを使ってbaserCMSのAPIをAIエージェント向けに公開しています。
+これにより、ChatやAIエージェントとの対話の中で「ブログ記事を書いて」「このカテゴリを追加して」といった指示を出すだけで、baserCMSサイトの更新が完結するようになります。
+ +BcMcpは、baserCMSが持つ主要な機能をひととおりカバーしています。
+つまり、記事の投稿だけでなく、baserCMSの汎用データベース機能（カスタムテーブル）を使った独自コンテンツの管理まで、AIエージェント経由でひととおり行えるようになっています。
+ +baserCMSは2010年の誕生以来、オープンソースのCMSとして進化を続けてきました。近年のAIエージェントの普及を受けて、baserCMSを「人が管理画面を操作するCMS」から一歩進めて、「AIエージェントが自律的に運用できるCMS（Agentic CMS）」として位置づけ直す取り組みの一環がBcMcpです。
+管理画面にログインして手作業で更新する代わりに、AIエージェントに指示を出すだけでサイト更新が完結する。BcMcpはそのための土台となるインターフェースです。
+ +ClaudeのようなAIアシスタントにBcMcpを接続すると、たとえば次のようなことが会話ベースで行えるようになります。
+これにより、コンテンツ更新のたびに管理画面を開いて手作業を行う必要がなくなり、AIとの対話の延長でサイト運用が進むようになります。
+ +BcMcpは、baserCMSをAIエージェントから直接操作できるようにするMCPサーバーです。ブログ管理からカスタムテーブルを使った独自コンテンツ管理まで幅広くカバーしており、baserCMSをAIネイティブに運用していくための重要なピースとなっています。
+EOF; + } + +} diff --git a/plugins/bc-mcp/tests/TestCase/Mcp/NegotiationLoggerTest.php b/plugins/bc-mcp/tests/TestCase/Mcp/NegotiationLoggerTest.php new file mode 100644 index 0000000000..9cdd3206ef --- /dev/null +++ b/plugins/bc-mcp/tests/TestCase/Mcp/NegotiationLoggerTest.php @@ -0,0 +1,187 @@ + + * Copyright (c) NPO baser foundation