mcp
ツールリファレンス
Clarity サーバーが公開する全 11 MCP ツールの完全なリファレンスです。
Clarity MCP サーバーは 4 つのカテゴリに分類された 11 のツール を公開しています。すべてのツール、パラメータ、使用タイミングを以下に示します。
プロジェクト & ファイルツール
list_projects
Clarity ワークスペース内のすべてのプロジェクトを一覧表示します。 ゴミ箱にない全プロジェクトのメタデータを返します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| （なし） | — | — | パラメータなし |
使用タイミング： 他のツールに必要な project_id を取得するためにここから始めます。
list_files
プロジェクト内のすべてのファイルを一覧表示します。 名前、タイプ、パス、メインファイルフラグを返します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
project_id | string | はい | プロジェクト ID |
使用タイミング： プロジェクトのファイルツリーを探索し、他のツールに必要な file_id の値を取得します。
read_file
ファイルの完全な内容を読み取ります。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
file_id | string | はい | 読み取るファイル ID |
使用タイミング： 編集、エラー診断、ファイルに関する質問への回答の前に使用します。
write_file
既存ファイルの内容を更新します。 ファイル全体を置換します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
file_id | string | はい | 更新するファイル ID |
content | string | はい | 新しいファイル内容 |
これはファイル全体を上書きします。必ず先にファイルを読み取ってから、完全な更新内容を送信してください。
create_file
プロジェクト内に新しいファイルを作成します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
project_id | string | はい | ファイルを作成するプロジェクト |
name | string | はい | 拡張子付きのファイル名 |
content | string | いいえ | 初期ファイル内容（デフォルトは空） |
parent_id | string | いいえ | 親フォルダ ID。省略するとプロジェクトルートに配置。 |
セーフティ機能：
- ファイル名を検証（スラッシュ不可、最大 255 文字）
- 同じフォルダ内の重複名を防止
- 親フォルダの存在を検証
delete_file
プロジェクトからファイルを削除します。 この操作は永続的です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
file_id | string | はい | 削除するファイル ID |
削除は永続的です。慎重に使用してください。
コンパイルとデバッグ
compile
プロジェクトをコンパイルして結果を返します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
project_id | string | はい | コンパイルするプロジェクト ID |
debug_compile
コンパイルして構造化されたエラー分析を返します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
project_id | string | はい | デバッグするプロジェクト ID |
Typst ドキュメント
typst_docs_search
組み込みの Typst ドキュメントライブラリを検索します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
query | string | はい | 検索クエリ |
正しい構文とパターンを使用するため、Typst コードを書く前にこのツールを使用してください。
typst_docs_read
特定の Typst ドキュメントファイルを読み取ります。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
path | string | はい | 検索結果の relativePath |
TikZ イラスト
tikz_illustrate
プロフェッショナルな TikZ イラストを生成します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
project_id | string | はい | プロジェクト ID |
description | string | はい | 描画する内容 |
file_name | string | いいえ | 図のファイル名 |
機能：
- フローチャートとプロセス図
- ニューラルネットワークアーキテクチャ
- 数学プロット（pgfplots 経由）
- 可換図式（tikz-cd 経由）
- ファインマンダイアグラム（tikz-feynman 経由）
- ツリー構造と階層構造
- 一般的な科学イラスト
典型的なワークフロー
編集してコンパイル
- 1
list_projects→ プロジェクトを見つける - 2
list_files→ 構造を探索 - 3
read_file→ 対象ファイルを読み取り - 4
write_file→ 変更を適用 - 5
compile→ コンパイルが通ることを確認
ビルド失敗のデバッグ
- 1
debug_compile→ 構造化されたエラー分析を取得 - 2
read_file→ エラーのあるファイルを読み取り - 3
write_file→ 問題を修正 - 4
compile→ 修正を確認
これらすべてを 1 つのプロンプトで実行できます：「methodology.tex という新しい章ファイルを作成し、TikZ フローチャートを追加し、main.tex にインクルードして、コンパイルして。」