@paragraph-com/mcp

用于 Paragraph 的 MCP（模型上下文协议）服务器 — 将你的出版物开放给 Claude Desktop、Cursor、VS Code Copilot 以及任何兼容 MCP 的客户端中的 AI 代理。

远程服务器（推荐）

使用托管在 mcp.paragraph.com 的服务器 — 无需安装或管理 API 密钥。你可以在浏览器中通过你的 Paragraph 账户进行身份验证。

Claude Code

claude mcp add paragraph --transport http https://mcp.paragraph.com/mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

VS Code

添加到 .vscode/mcp.json：

{
  "servers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

Related MCP server: thegraph-mcp

本地服务器

如果你更倾向于在本地运行服务器，可以使用 npx。需要 Node.js 18 或更高版本。

npx @paragraph-com/mcp

身份验证（仅限本地）

远程服务器会自动处理身份验证。对于本地使用，请通过环境变量设置你的 API 密钥：

PARAGRAPH_API_KEY=your-key npx @paragraph-com/mcp

或者使用 Paragraph CLI 登录 — MCP 服务器共享相同的配置：

npx @paragraph-com/cli login
npx @paragraph-com/mcp

按客户端进行本地设置

claude mcp add paragraph -- npx @paragraph-com/mcp

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "paragraph": {
      "command": "npx",
      "args": ["@paragraph-com/mcp"],
      "env": {
        "PARAGRAPH_API_KEY": "your-key"
      }
    }
  }
}

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "paragraph": {
      "command": "npx",
      "args": ["@paragraph-com/mcp"],
      "env": {
        "PARAGRAPH_API_KEY": "your-key"
      }
    }
  }
}

Streamable HTTP（本地）

npx @paragraph-com/mcp --http --port 3100

HTTP 模式绑定到 127.0.0.1（仅限 localhost）并接受 POST 请求。可通过 GET /health 进行健康检查。

可用工具

文章

• get-post — 按 ID 或 slug 获取文章

• list-posts — 列出某个出版物的文章或你自己的文章

• create-post — 创建新文章（markdown）

• update-post — 更新现有文章

• delete-post — 删除文章

• send-test-email — 为草稿发送测试通讯

内容

草拟的短内容 — X 帖子和线程、LinkedIn 帖子、一次性电子邮件和 X Articles。这些工具仅负责起草；作者从 Paragraph 应用中发送内容。

• create-content — 将内容保存到你的出版物库中

• list-content — 列出你的内容库，可按类型和状态筛选

• get-content — 获取一条内容及其正文

• update-content — 重命名内容或替换其正文

• archive-content — 将内容归档而不删除

• restore-content — 将已归档的内容恢复

出版物

• get-publication — 按 ID、slug 或域名获取出版物元数据

订阅者

• list-subscribers — 列出你的订阅者

• get-subscriber-count — 获取订阅者数量

• add-subscriber — 通过电子邮件或钱包添加订阅者

用户

• get-user — 按 ID 或钱包获取用户资料

代币

• get-coin — 获取代币元数据或列出热门代币

• list-coin-holders — 获取代币持有者

搜索

• search-posts — 搜索文章

• search-blogs — 搜索出版物

• search-coins — 搜索代币

信息流

• get-feed — 获取精选的平台信息流

我的

• get-me — 获取你已认证的出版物信息

分析

• analytics-query — 针对你出版物的分析数据运行只读 SQL 查询（打开率、CTR、订阅者数量、热门文章等）

• analytics-schema — 列出分析模式中可用的表和列

工具集筛选

只暴露你的代理所需的工具：

npx @paragraph-com/mcp --toolsets posts,search

可用的工具集：posts、content、publications、subscribers、users、coins、search、feed、me、analytics、emails

示例

搜索并总结某个主题的文章

提示词： “搜索关于链上治理的文章，并给我一份热门结果的摘要”

MCP 服务器会使用该查询调用 search-posts。Claude 接收匹配的文章，并综合出关键主题、作者和出版物的摘要。

起草并发布博客文章

提示词： “写一篇标题为 ‘Weekly Update #12’ 的文章，介绍我们的新代币门控功能，然后发布它”

服务器会使用标题和生成的 markdown 内容调用 create-post，将其创建为草稿。在你确认后，它会调用 update-post 将状态设置为 published，使其在你的出版物上发布。

获取订阅者分析

提示词： “我的出版物有多少订阅者？给我看看最近的订阅者。”

服务器会调用 get-me 来识别你的出版物，然后调用 get-subscriber-count 获取总数，并调用 list-subscribers 返回最新订阅者及其详细信息。

回答关于通讯表现的问题

提示词： “过去 30 天我的平均打开率是多少？哪些文章表现最好？”

服务器会使用针对 post_analytics_summary 的限定范围 SQL 查询调用 analytics-query，返回每篇文章的打开率、CTR 和浏览量。Claude 会总结趋势并突出表现最好的文章。

浏览平台信息流

提示词： “Paragraph 上现在有什么热门内容？”

服务器会调用 get-feed 获取精选的平台信息流，Claude 会总结热门文章、作者和主题。

管理文章生命周期

提示词： “给我看看我的草稿，并为最新的一篇发送测试邮件”

服务器会使用 status: draft 调用 list-posts 来获取你的草稿，然后使用最新草稿的 ID 调用 send-test-email，这样你就可以在发送给订阅者之前，在收件箱中预览通讯。

支持

• 问题与错误： GitHub Issues

• 电子邮件： support@paragraph.com

• 网站： paragraph.com

发布

npm run release patch   # 1.0.0 → 1.0.1
npm run release minor   # 1.0.0 → 1.1.0
npm run release major   # 1.0.0 → 2.0.0

构建、测试、发布到 npm、部署 mcp.paragraph.com 上的 Cloudflare Worker，并创建 GitHub release。脚本会提示你提供任何缺失的凭据。

隐私政策

此 MCP 服务器会代表你连接到 Paragraph API。有关数据收集、使用、存储以及你的权利的详细信息，请参阅 Paragraph 隐私政策。

许可证

MIT