内容
# @misarblog/mcp — Misar.Blog MCP 服务器
**从 Claude Code、Cursor 或 Windsurf 发布和管理您的博客**
[](https://www.npmjs.com/package/@misarblog/mcp)
[](https://opensource.org/licenses/MIT)
[](https://nodejs.org/)
[](https://smithery.ai/server/misar/misarblog-mcp)
发布博客文章、管理草稿、组织系列、运行 AI 研究/标题/封面图像生成，并获取分析数据 — 所有这些都可以在您的 AI 编码环境中完成。通过 API 密钥或一键`登录`浏览器流程（无需复制粘贴）连接您的 [Misar.Blog](https://www.misar.blog) 创建者帐户。
stdio 包公开了 **23 个工具**。在托管的 [Smithery](https://smithery.ai/server/misar/misarblog-mcp) 远程服务器（可流式传输的 HTTP）上，**20 个工具可用** — 三个仅限本地的工具（`login`、`status`、`upload_image`）需要本地进程，不可通过远程 HTTP 访问。
---
## 安装
### Claude Code
```bash
claude mcp add misarblog -- npx -y @misarblog/mcp
```
然后设置您的 API 密钥：
```bash
export MISARBLOG_API_KEY=mbk_your_key
```
### 手动配置（Cursor、Windsurf、VS Code、任何 MCP 客户端）
```json
{
"mcpServers": {
"misarblog": {
"command": "npx",
"args": ["-y", "@misarblog/mcp"],
"env": {
"MISARBLOG_API_KEY": "mbk_your_key"
}
}
}
}
```
- **Cursor** — `~/.cursor/mcp.json`（全局）或 `.cursor/mcp.json`（项目）
- **Windsurf** — `~/.codeium/windsurf/mcp_config.json`
- **VS Code (Copilot)** — `.vscode/mcp.json`，在服务器条目中添加 `"type": "stdio"`
### 主机远程（无需本地安装）
直接从 Smithery 安装托管服务器 — 它为您运行包并通过可流式传输的 HTTP 连接：
```bash
npx -y @smithery/cli install misar/misarblog-mcp --client claude
```
或直接添加远程端点并使用 Bearer API 密钥进行身份验证：
```
https://www.misar.blog/api/mcp
Authorization: Bearer mbk_your_key
```
---
## 身份验证
**选项 1 — API 密钥（推荐）。** 在 **[仪表盘 → 设置 → API 密钥](https://www.misar.blog/dashboard/settings/api-keys)** 处生成密钥（以 `mbk_` 开头），然后设置 `MISARBLOG_API_KEY`。密钥每分钟限制 100 个请求，可以随时撤销或重新生成。
**选项 2 — 浏览器登录（仅限stdio）。** 省略 `MISARBLOG_API_KEY` 并调用 `login` 工具作为您的第一个请求。它启动一个临时的 `127.0.0.1` 监听器，打开 `https://www.misar.blog/dashboard/settings/api?mcp_port=<port>`，并将返回的密钥保存到 `~/.misarblog/config.json` — 无需剪贴板。监听器仅限本地并且在 120 秒后关闭。
---
## 工具
stdio 上有 **23 个工具**；标记为 ✓ 的 **20 个工具** 也可在 Smithery 远程服务器上使用。
| 领域 | 工具 | 远程 |
|------|-------|:------:|
| 连接与账户 | `login`、`status` | — |
| | `get_profile` | ✓ |
| 文章与草稿 | `list_my_articles`、`get_article`、`publish_article`、`create_draft` | ✓ |
| 系列 | `get_series`、`create_series`、`add_to_series` | ✓ |
| AI 写作 | `research_topic`、`generate_title_seo`、`suggest_titles` | ✓ |
| 图片 | `upload_image` | — |
| | `generate_cover_image` | ✓ |
| 分析 | `get_analytics_summary` | ✓ |
| 评论与关注 | `list_comments`、`get_follow_status` | ✓ |
| 反应 | `get_reactions`、`add_reaction`、`remove_reaction` | ✓ |
| 通讯稿 | `list_newsletter_subscribers`、`list_newsletter_issues` | ✓ |
完整的参数表、返回形状和示例提示在 **[MCP 工具参考](https://docs.misar.io/blog)** 中。
---
## 使用示例
您可以在 Claude Code 或 Cursor 代理模式下直接发送的提示：
```text
撰写一篇关于“为什么 AI 优先的博客改变 SEO 永恒”的 1000 字文章，并使用标签 [“AI”, “SEO”, “blogging”] 在我的 Misar.Blog 上发布。
```
```text
为一篇名为“使用 MCP 构建”的文章生成一个黑暗的、未来主义的封面图像，然后创建一个以该图像作为封面的草稿。
```
```text
列出我已发布的文章，创建一个名为“AI 写作指南”的系列，并按时间顺序将最后 3 篇文章添加到其中。
```
```text
显示我过去 90 天的分析数据。
```
---
## 自托管 Misar.Blog
使用 `MISARBLOG_BASE_URL` 将服务器指向您自己的实例：
```json
{
"mcpServers": {
"misarblog": {
"command": "npx",
"args": ["-y", "@misarblog/mcp"],
"env": {
"MISARBLOG_API_KEY": "mbk_your_key",
"MISARBLOG_BASE_URL": "https://blog.yourdomain.com"
}
}
}
}
```
---
## 要求
- **Node.js** >= 18（包通过 `npx` 自动获取）
- [Misar.Blog](https://www.misar.blog) 创建者帐户
- 来自您的 [仪表盘](https://www.misar.blog/dashboard/settings/api-keys) 的 API 密钥，或 `login` 工具
---
## 链接
- **首页** — https://www.misar.blog
- **Smithery** — https://smithery.ai/server/misar/misarblog-mcp
- **文档** — https://docs.misar.io/blog
- **npm** — https://www.npmjs.com/package/@misarblog/mcp
- **源码** — https://git.misar.io/misaradmin/misar-io (`packages/blog-mcp-server/`)
## 许可证
MIT — 版权所有 (c) 2026 Misar AI Technology Pvt Ltd
