Marimo 文档 MCP 服务器

这是一个基于模型上下文协议（MCP）的服务器，提供对 Marimo 文档 的访问。

这个基于TypeScript的MCP服务器允许您获取并搜索Marimo的API文档，提供对所有文档部分中的组件、接口和示例的结构化访问。

功能

工具

get_element_api

获取Marimo UI元素或组件的详细API文档。

• 输入：element（字符串）- 要获取文档的元素名称（例如，“slider”，“button”）
• 输出：包括以下内容的结构化API文档：
  • 标题和描述
  • 参数及其类型和默认值
  • 代码示例
  • 使用模式

search_api

在整个Marimo API文档中进行搜索。

• 输入：query（字符串）- 在文档中查找的搜索词
• 输出：来自任何部分的匹配文档条目数组

文档部分

该服务器提供了对所有Marimo组件文档的访问：

输入

• 表单元素（按钮、复选框、下拉菜单等）
• 数据输入（数组、数据帧、字典）
• 文件处理（文件、文件浏览器）
• 交互元素（滑块、范围滑块、标签页）

布局

• 结构组件（折叠面板、侧边栏、树形图）
• 组织工具（提示框、轮播图）
• 内容管理（懒加载、路由）

媒体

• 媒体元素（音频、视频、图像）
• 文件处理（下载、PDF）
• 文本显示（纯文本）

核心功能

• 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

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

调试

由于MCP服务器通过标准I/O通信，调试可能会很困难。在开发过程中，服务器会向stderr输出详细的日志。

您还可以使用MCP Inspector：

npm run inspector

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

错误处理

服务器提供的组织错误消息：

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

实现细节

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