Skip to content

fix(mcp): drop root .mcp.json; surface alwaysLoad in claude_desktop_config.json examples instead #141

@liplus-lin-lay

Description

@liplus-lin-lay

目的

PR #140 で repo root に新規追加した .mcp.json を削除し、alwaysLoad: true の推奨先を実際の install 経路 (claude_desktop_config.json) の docs に置き換える。

背景

PR #140 (#139 の実装) で repo root に .mcp.json を新規作成して alwaysLoad: true を入れた。仕様確認の結果、これは現フェーズに合わない:

  • Li+ MCP 群 (github-webhook-mcp / github-rag-mcp) は preview 運用中、distribution level には至っていない
  • 現在の想定 install パスは Claude Desktop の claude_desktop_config.json への manual install のみ
  • Claude Code 仕様確認:
    • project .mcp.json は Claude Code 専用 scope (公式 docs: https://code.claude.com/docs/en/mcp)
    • Claude Desktop は .mcp.json を読まない / UI で surface しない
    • Master の手元で「動くけど見えない」状態は仕様通り、設定ミスではない
  • root .mcp.json は preview phase の現状では:
    • Desktop config 既登録ユーザーには重複 / override の混乱要因
    • 「manual install only」の前提と齟齬

前提

  • 本 MCP の canonical install path = Claude Desktop の claude_desktop_config.jsonmcpServers セクション (stdio transport via npx -y github-rag-mcp@latest)
  • 既存 mcp-server/README.md には claude_desktop_config.json 例が掲載済 (PR feat(mcp): add alwaysLoad: true to plugin .mcp.json #140 では未編集)
  • alwaysLoad は Claude Code v2.1.121+ で認識される field、stdio / http 共通で使える

方針判断

Master 判断 (2026-04-28): preview phase 中は手動 install ユーザーだけを前提とする。長期的には Li+ は MCP なしでも動くように設計する方向 ── これは別 issue で温める。

制約

  • root .mcp.json は削除する (新規作成だったため revert ではなく delete)
  • 既存の claude_desktop_config.json 例 (mcp-server/README.md 等) に "alwaysLoad": true を追記
  • README / installation 系 docs にも alwaysLoad 推奨を一行ずつ
  • Claude Code v2.1.121 release 日付 (2026-04-28) と version 要件を docs に明記

対象ファイル

  • .mcp.json (削除)
  • mcp-server/README.mdclaude_desktop_config.json
  • README / docs/installation 系で touch 可能な箇所

参考

Metadata

Metadata

Assignees

No one assigned

    Labels

    bug動いていない、壊れているmemoメモとして開始した状態。見出しは必要なものだけでよい

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions