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

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions