🚀 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
• 状态管理
• 以及其他更多...

📦 安装指南

使用 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"]
    }
  }
}

💻 使用示例

基础用法

# 安装依赖
npm install

# 构建服务器
npm run build

# 带自动重建的开发
npm run watch

📚 详细文档

调试

由于 MCP 服务器通过标准输入输出进行通信，调试可能会比较困难。在开发过程中，服务器会将详细的日志输出到标准错误流。

您还可以使用 MCP Inspector：

npm run inspector

Inspector 将提供一个可以在浏览器中访问调试工具的 URL。

错误处理

该服务器提供了有组织的错误消息，这些消息：

• 列出按部分分组的所有可用元素
• 提供无效请求的清晰反馈
• 包括适当的 HTTP 错误代码

🔧 技术细节

• 使用 Cheerio 进行文档页面的 HTML 解析
• 实现了缓存以减少文档获取请求的数量
• 处理所有文档部分的正确 URL 构造
• 支持文档内容的递归搜索