Marimo Docs MCP

🚀 Marimo ドキュメント MCP サーバー

TypeScript ベースの MCP サーバーで、Marimo ドキュメント へのアクセスを提供します。これにより、すべての API ドキュメント、コンポーネント、インターフェース、およびサンプルを検索および閲覧できます。

✨ 主な機能

ツール

get_element_api

任意の Marimo UI 要素またはコンポーネントの詳細な API ドキュメントを取得します。

• 入力：element (文字列) - ドキュメントを取得する要素の名前（例: “slider”、“button”）
• 出力：構造化された API ドキュメントで、以下を含みます。
  • タイトルと説明
  • パラメーターとその型およびデフォルト値
  • コード例
  • 使用パターン

search_api

すべての Marimo API ドキュメント内で検索を行います。

• 入力：query (文字列) - ドキュメント内で検索する用語
• 出力：任意のセクションからの一致するドキュメントエントリの配列

ドキュメントセクション

このサーバーは、すべての Marimo コンポーネントのドキュメントへのアクセスを提供します。

入力

• フォーム要素（button、checkbox、dropdown など）
• データ入力（array、dataframe、dictionary）
• ファイル処理（file、file_browser）
• インタラクティブ要素（slider、range_slider、tabs）

レイアウト

• 構造化コンポーネント（accordion、sidebar、tree）
• 組織ツール（callout、carousel）
• コンテンツ管理（lazy、routes）

メディア

• メディア要素（audio、video、image）
• ファイル処理（download、pdf）
• テキスト表示（plain_text）

コア機能

• Markdown
• 制御フロー
• 可視化
• HTML
• 状態管理
• その他...

🔧 開発

依存関係のインストール：

npm install

サーバーのビルド：

npm run build

自動再構築を伴う開発：

npm run watch

📦 インストール

Claude デスクトップ版を使用する場合

以下のファイルに追加します。

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "marimo-docs": {
      "command": "/path/to/marimo-docs/build/index.js"
    }
  }
}

VSCode Cline 拡張を使用する場合

以下のファイルに追加します。

• MacOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
• Windows: %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "marimo-docs": {
      "command": "node",
      "args": ["/path/to/marimo-docs/build/index.js"]
    }
  }
}

💻 デバッグ

MCP サーバーは標準入出力を介して通信するため、デバッグは困難な場合があります。開発中は、サーバーは詳細なログを標準エラーストリームに出力します。

また、MCP Inspector を使用することもできます。

npm run inspector

Inspector は、ブラウザでアクセスできるデバッグツールの URL を提供します。

🚧 エラー処理

このサーバーは、以下のような組織化されたエラーメッセージを提供します。

• セクションごとにグループ化されたすべての利用可能な要素をリストする
• 無効なリクエストに対する明確なフィードバックを提供する
• 適切な HTTP エラーコードを含む

🔧 技術詳細

• Cheerio を使用してドキュメントページの HTML 解析を行う
• ドキュメント取得リクエストの数を減らすためにキャッシュを実装する
• すべてのドキュメントセクションの正しい URL 構築を処理する
• ドキュメント内容の再帰的な検索をサポートする