Tanstack Mcp

TanStack MCP Server

🚀 AI コーディングエージェントと TanStack エコシステムをつなぐ究極のブリッジです。

公式品質の Model Context Protocol (MCP) サーバーです。TanStack CLI のあらゆる機能を AI アシスタントから直接利用できます。チャットを離れることなく、公式ドキュメントの検索、ライブラリの確認、ガイドの取得、新しいプロジェクトのスキャフォールディングを AI で行えます。

---

🌟 主な機能

• API キー不要のドキュメント検索：API キーなしで公式 TanStack ドキュメント（Algolia バックエンド）を検索できます。
• 全文ガイド：エコシステム内のあらゆるページの Markdown コンテンツをリアルタイムで取得できます。
• プロジェクトのスキャフォールディング：AI の支援によるコマンドで、新しい TanStack Start アプリケーションを作成できます。
• エコシステムの確認：16 以上のライブラリ、エコシステムパートナー（ホスティング、認証、DB）、バージョン情報を一覧表示できます。
• CLI の機能：スキャフォールディング、アドオン、バージョン固定ツールに直接アクセスできます。

---

🛠️ ツールのリファレンス

ツール	用途
search_tanstack_docs	クエリ、ライブラリ、フレームワークのフィルターを使って、公式 TanStack ドキュメントを検索します。
fetch_tanstack_doc	ドキュメントページの Markdown コンテンツ全体を取得します（例：router、guide/file-based-routing）。
list_tanstack_libraries	公式 TanStack ライブラリ（Query、Router、Table、Form など）をすべて確認できます。
list_tanstack_ecosystem	ホスティング、認証、データベースなどのパートナーを確認できます。
create_tanstack_project	カスタムアドオン設定を使って、新しい TanStack Start プロジェクトを立ち上げます。
add_tanstack_addon	既存のプロジェクトにアドオン（Tailwind、Clerk など）をインストールします。
pin_tanstack_versions	安定性を保つため、package.json 内のすべての TanStack ライブラリのバージョンを固定します。

---

💻 設定

npx または Docker を使ってサーバーを実行できます。

方法 1：NPX（推奨）

MCP 設定ファイルに以下を追加します。

{
  "mcpServers": {
    "tanstack": {
      "command": "npx",
      "args": ["-y", "@gihan92/tanstack-mcp"]
    }

  }
}

方法 2：Docker

要件：Docker Desktop が起動している必要があります。

{
  "mcpServers": {
    "tanstack": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "gihan92/tanstack-mcp:latest"
      ]
    }
  }
}

---

🚀 ローカル開発

サーバーに貢献する場合、またはローカルでテストする場合：

1. リポジトリをクローンする：

   git clone https://github.com/your-username/tanstack-mcp.git
   cd tanstack-mcp
   

2. 依存関係をインストールする：

   pnpm install
   

3. 開発モードで実行する：

   pnpm dev
   

4. 本番用にビルドする：

   pnpm build
   

---

📝 クレジットとライセンス

このサーバーは、公式の @tanstack/cli をラップしたものです。すべてのドキュメントとライブラリデータは TanStack の所有物です。

作者： gihan92