Tanstack Mcp

TanStack MCP 服务

🚀 AI 编码 Agent 与 TanStack 生态系统之间的终极桥梁。

一个官方级别的 Model Context Protocol (MCP) 服务，将 TanStack CLI 的全部能力直接带入你的 AI 助手。它能让你的 AI 搜索官方文档、发现库、获取指南并搭建新项目——全程无需离开聊天界面。

---

🌟 主要功能

• 免密文档搜索：搜索 TanStack 官方文档（使用 Algolia 后端），无需任何 API 密钥。
• 全文指南：获取生态系统中任意页面的实时 Markdown 内容。
• 项目搭建：通过 AI 辅助命令创建新的 TanStack Start 应用。
• 生态系统发现：列出 16+ 个库、生态系统合作伙伴（托管、身份验证、数据库）和版本信息。
• 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