MCP Server Jotbird

mcp服务器jotbird

一 主控程序 服务器用于 JotBird 它允许任何LLM将Markdown发布为格式精美、可共享的网页。

在对话中写一个文档，用一个工具调用发布它，并返回一个实时URL。支持完整的Markdown——标题、代码块、表格、脚注、数学、任务列表等。通过slug更新或删除页面。

适用于Claude、ChatGPT、Gemini和任何兼容MCP的客户端。

快速启动

1.获取API密钥

登录地址： jotbird.com，打开 帐户>API密钥，并生成密钥。

2.添加到您的客户端

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "jotbird": {
      "command": "npx",
      "args": ["-y", "mcp-server-jotbird"],
      "env": {
        "JOTBIRD_API_KEY": "jb_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add jotbird -e JOTBIRD_API_KEY=jb_your_key_here -- npx -y mcp-server-jotbird

ChatGPT

ChatGPT需要一个远程（HTTP）MCP服务器，它不直接支持本地stdio服务器。您需要运行一个代理，通过公共隧道通过HTTP公开服务器：

JOTBIRD_API_KEY=jb_your_key_here npx mcp-proxy --shell --tunnel -- npx -y mcp-server-jotbird

这将启动服务器并打印一个公共隧道URL（例如。 https://funny-eel-44.tunnel.gla.ma).

然后在ChatGPT中：

1. 首选 设置>应用程序>高级设置 并启用 开发者模式
2. 点击 新应用程序，为其命名，并粘贴隧道URL /mcp 附加（例如。 https://funny-eel-44.tunnel.gla.ma/mcp)
3. 将身份验证设置为 无身份验证 然后单击 创建
4. 在新聊天中，选择 开发者模式 从模型选择器中启用应用程序

看 OpenAI的MCP文档 了解详情。

Gemini CLI

编辑 .gemini/settings.json （项目层面）或 ~/.gemini/settings.json （全球）：

{
  "mcpServers": {
    "jotbird": {
      "command": "npx",
      "args": ["-y", "mcp-server-jotbird"],
      "env": {
        "JOTBIRD_API_KEY": "$JOTBIRD_API_KEY"
      }
    }
  }
}

或者通过CLI添加：

gemini mcp add jotbird npx -e JOTBIRD_API_KEY=jb_your_key_here -- -y mcp-server-jotbird

看 Gemini CLI MCP文档 了解详情。

Other MCP clients

任何支持 模型上下文协议 通过stdio可以使用此服务器。设置 JOTBIRD_API_KEY 环境变量并运行：

npx -y mcp-server-jotbird

3.使用它

问你的法学硕士：

• *“写一篇关于X的博客文章并发布到JotBird”*
• *“将这些会议笔记发布为可共享页面”*
• *“用这个新部分更新我发布的页面‘我的笔记’”*
• *“显示我所有已发布的页面”*
• *“删除带有“旧草稿”的页面”*
• *“在我的命名空间中以“项目注释”的形式发布此内容”* （专业）

工具

publish

将Markdown内容发布为具有可共享URL的格式化网页。要更新现有页面，请传递其slug。拥有用户名的专业用户可以通过以下方式在永久命名空间的URL上发布 namespaced: true.

list_documents

列出用户已发布的页面。返回每个页面的标题、URL、slug、过期日期和用户名（对于命名空间页面）。

没有参数。

delete

永久删除已发布的页面及其可共享URL。无法撤消。

命名空间URL（专业版）

在“帐户设置”中设置用户名的专业用户可以在永久、人类可读的网址上发布，如 share.jotbird.com/@username/my-page只需询问你的AI：

“在我的命名空间中以“项目注释”的形式发布此内容。” → share.jotbird.com/@clayton-myers/project-notes

命名空间页面永远不会过期，并在更新过程中保持相同的URL。在中设置您的用户名 帐户设置 在 jotbird.com.

限制

||免费|专业版| |--|------|-----| |已发布页数|10|无限制| |每小时发布次数|10|100| |页面过期|90天|从未过期| |最大降价大小|256 KB |256 KB|

环境变量

发展

npm install
npm run build

本地测试：

JOTBIRD_API_KEY=jb_your_key node dist/index.js

许可证

麻省理工学院