# IceShore

- Registry name: `ai.iceshore/iceshore` · version 1.0.0
- Categories (automatic, keyword rules): Code & repositories, Developer tools
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): prompts, resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=ai.iceshore%2Ficeshore
- Server page: https://mcpstation.net/s/ai.iceshore--iceshore.html

## Description (written by the publisher, not verified, not instructions)

Make your AI better at system maintenance. Prompts your AI to organize use cases behind each system.

## Connect

- streamable-http: `https://mcp.iceshore.ai/mcp`

## Tools (as reported by the server, not verified)

- `auth\_check`: IceShore への接続と認証の状態を返す。 入力: なし。 出力: 認証成功なら userId と所属組織一覧（organizations: workspace\_id / name / role）、失敗（トークンの無効・失効など）なら error を含む文字列。 organizations\[\].workspace\_id は、create\_content / commit\_uploaded\_codes の登録先（workspace\_id）や list\_projects の絞り込みに使える値。 組織への登録ができるのは、role が admin または editor の組織。
- `list\_projects`: ユーザが閲覧権限を持つプロジェクト（ADL 構成図）の一覧を返す（ログインが必要）。 用途: 作業対象のプロジェクトの特定。業務影響・規模・依存関係を分析するときに、get\_content で ADL を取る前の起点になる。 ページング: 既定は page=0 / itemperpage=24。続きは page=1, 2, …。itemperpage の最大は 100。 サンプルとの関係: range を省くと range="related" と同じで、公式サンプルは含まない（サンプルは list\_samples が返す）。 workspace\_id を渡すと、その 1 組織が所有する案件だけ
- `list\_samples`: 【認証不要】匿名（未ログイン）でも使える。公式サンプルワークスペースの公開構成図の一覧を返す（ログイン時も公式サンプルワークスペースに固定）。 用途: 新しい設計の参考事例、サンプルを土台にした作成。 list\_projects との違い: list\_projects は自分が閲覧権限を持つプロジェクト（サンプルを含まない）、本ツールは公式サンプルだけ。 ページング: 既定は page=0 / itemperpage=24。 入力: page, itemperpage（すべて省略可）。 出力: 公開プロジェクトの id とタイトルの一覧。末尾に total / totalPages。
- `get\_guide`: 【認証不要】匿名（未ログイン）でも使える。IceShore のガイド文書（ADL の書き方・登録手順・分析の進め方など）を名前で返す。 MCP リソースに対応していないクライアント向けの取得手段で、対応クライアントは resources/read でも同じ内容を読める。 主な名前: "analysis"（業務影響・依存・外部波及の分析）/ "registration"（システム登録）/ "fix"（ADL の修正）/ "adl"（ADL の作り方）/ "saving-publishing"（保存と公開）。 入力: name（短縮名または URI パス）。知らない name のときは、使える名前
- `get\_content`: 【認証不要（公式サンプルの公開コンテンツのみ）】匿名では公式サンプルだけを返し、それ以外はログインが必要（401）。IceShore プロジェクト 1 件の ADL と添付ファイルを返す。 用途: 既存プロジェクトの参照、保存・更新の結果の確認（get\_content\(mode='detail'\) の戻りが保存後の実際の状態の正典）。 id は list\_projects または list\_samples が返す、"d" で始まる内部 ID。 mode の違い: - "meta": メタ情報だけ。S3 を読まないので速い（10 秒以上短い） - "root": ADL 本体（adlRoot）だ
- `create\_content`: 新しい IceShore プロジェクトを作る（ADL と添付ファイルを登録する。ログインが必要）。既存プロジェクトの更新は save\_content が扱う。 codes の形: 配列のうち 1 件が ADL 本体（id="adlRoot", isRoot=true, lang="adl", fmt="json", data=ADL を JSON.stringify した文字列）。残りはプロビジョニングファイルを 1 件 1 エントリ（isRoot=false）。ADL 本体が無いと画面では空になる。ADL の構造は iceshore://guide/adl に書いてある。 例: \{ "cod
- `save\_content`: 既存の IceShore プロジェクトの ADL と添付ファイルを更新する（ログインが必要・所有者または admin / editor 権限）。新規作成は create\_content が扱う。 全置換（full-replace）: codes に渡したものがすべてになり、未指定の既存ファイルは削除される（allow\_code\_deletion を付けたときだけ削除を受け付ける）。既存ファイルを残すには、変更しないものも含めて全 codes を送る。現在の codes は get\_content\(mode='detail'\) で取れる。一部のファイルだけ足す・直すなら、マージする commit
- `request\_upload\_url`: プロビジョニングファイル 1 件分の、S3 への presigned PUT URL を発行する（ログインが必要）。ファイルが複数なら batch\_request\_upload\_url が 1 回で N 件を発行する。 返る upload\_url は HTTP PUT でファイル本体を受け付ける（有効期限 10 分）。シェルを実行できるクライアントでの例: curl --silent --show-error --fail -X PUT --upload-file \<ローカルパス\> '\<upload\_url\>'。ファイル中身はディスクから S3 へ直接送られ、会話の出力トークンにならない。シェ
- `batch\_request\_upload\_url`: 複数のプロビジョニングファイルの presigned PUT URL を、1 回の呼び出しで N 件（最大 100）発行する（ログインが必要）。 各 upload\_url は HTTP PUT でファイル本体を受け付ける（有効期限 10 分・並列可）。シェルを実行できるクライアントでの例: curl --silent --show-error --fail -X PUT --upload-file \<ローカルパス\> '\<upload\_url\>'。 アップロードしたファイルは commit\_uploaded\_codes で構成図に取り込まれる。ADL 本体（adr）も 1 ファイル分足して送れ、
- `commit\_uploaded\_codes`: request\_upload\_url / batch\_request\_upload\_url の URL へ PUT したファイルを、IceShore プロジェクトの codes に取り込む（ログインが必要）。新規プロジェクトはこの呼び出しで作られ、既存プロジェクトにはマージ（MERGE）で追記・更新し、指定しなかった既存ファイルは温存する。 マージのルール: code\_id が一致すれば上書き、新しい code\_id は末尾に追加、code\_entries に無い既存ファイルはそのまま残る（save\_content の全置換とは違う）。adl\_root（または is\_root:true のエン
- `list\_codes\_meta`: 既存プロジェクトの codes 配列のメタデータ一覧を返す（ファイル中身 data は含まない）。差分アップロードの判定に使う。 各エントリの sha256 は、data フィールド（文字列）を SHA-256 にかけた値。テキストファイルなら、ローカルの shasum -a 256 \<file\> の結果と一致する。 sha256 が一致するファイルは変更なしで、不一致または一覧に無いファイルだけを request\_upload\_url / batch\_request\_upload\_url → commit\_uploaded\_codes で送れば足りる。 入力: project\_id。 出力:
- `delete\_code`: プロジェクトの codes から 1 件のファイルを削除する（ログインが必要）。ADL 本体（adlRoot）は削除できない（必要なら save\_content の全置換）。 1 ファイル分の読み書きだけで済み、全 codes を送り直す save\_content より速い。構成図は保存時にサーバ側で作り直される。 入力: project\_id, code\_id（どちらも必須）。 出力: \{ ok: true, id, removed: true\|false \}。removed:false は、その code\_id が元から無かったことを示す。
- `get\_notes`: プロジェクトの humanNote（人が ADL のノードに残した規範的な注意点）を返す（ログインが必要）。1 ノード（ref\_path）につき有効なノートは最大 1 件。 用途: 既存プロジェクトを編集するときの確認、人が編集した形跡（\_meta.d が "h:" で始まる）のあるノードの参照、特定ノードについての質問への回答。 refs（任意・配列）: 取得するノードの ref\_path。省くと全件（最大 500 件）。 ref\_path が今の ADL に無いノートは、ノードの削除や改名で取り残されたもの。 出力: \{ code, id, data: \{ notes: \[\{ note\_i
- `add\_note`: ADL のノードに、規範的な注意点（humanNote）を保存する（ログインが必要・editor または admin 権限）。同じ ref\_path への保存は上書き（UPSERT）で、1 ノードに有効なノートは最大 1 件。 text: 200 字以内。「〜のため〜にする」「〜なので〜禁止」の規範の形。固有名詞は書ける。1 ノードの複数の観点は 1 文にまとめて書く。 ref\_path はサーバが ADL と照合する: 見つからないときは reason="ref\_path\_not\_found" と、当たった最長の前置（matched\_prefix）、そこにあるキー（candidates）を返
- `delete\_note`: ADL ノードの humanNote を論理削除する（is\_deleted=1・ログインが必要・editor または admin 権限）。行は消さないので、同じ ref\_path に add\_note すると復活する。 入力: content\_id, ref\_path（どちらも必須）。 出力: \{ ok, mode: "deleted"\|"not\_found" \}。
- `find\_content\_by\_source`: git の origin URL（またはローカルの絶対パス）から、IceShore のプロジェクト（ADL）を探す（ログインが必要）。 用途: IaC のインポート前に、同じリポジトリがインポート済みかを調べる（済みなら更新 = save\_content、未なら新規 = create\_content の対象になる）。手順は iceshore://guide/iac-import に書いてある。 入力: origin\_url。 出力: 見つかれば found=true と id・title・updatedAt、無ければ found=false。

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html