thoth-mcp

本地服务

github.com/perminder-klair商业与营销211 周前更新

代码仓库

关于 thoth-mcp

thoth-mcp 是通过 Hibiki API 创建和管理内容的 MCP 服务，面向 AI 助手和内容团队。它支持针对社交平台和博客生成内容，并提供品牌样式、图片生成与排期功能。

主要功能

01生成多平台内容
02应用品牌样式
03按需生成图片和话题标签
04安排并管理帖子
05分页筛选和检索帖子

适用场景

01起草针对不同平台的营销帖子
02安排社交帖子稍后发布
03检查或更新已有帖子
04让内容遵循品牌规范

MCP 相关

通过六种工具提供 Hibiki 内容的创建与管理，并提供帖子和平台预览资源。支持 stdio 与 HTTP 传输。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "zeiq-co-thoth": {
      "command": "npx",
      "args": [
        "-y",
        "@usethoth/mcp-server"
      ]
    }
  }
}

启动命令npx -y @usethoth/mcp-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@usethoth/mcp-server1.0.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Hibiki MCP 服务

适用于 Hibiki 内容创作平台的模型上下文协议（MCP）服务。此服务可让 AI 助手和工具通过 Hibiki 的 API 创建和获取内容。

**✨ 新增：**现已推出 Claude Code 插件，包含斜杠命令和专用 AI Agent，助力简化内容创作工作流！

快速开始

# Install via npx
npx @hibiki/mcp-server --api-key YOUR_API_KEY

# Or configure in Claude Desktop (see Configuration below)

在 www.gethibiki.com/settings/api-keys 获取 API 密钥

功能

创建内容：借助 AI 增强功能，生成针对平台优化的内容
获取和管理帖子：通过分页获取、列出和更新帖子数据
多平台支持：Twitter、Instagram、LinkedIn、Facebook、Threads、博客、Reddit
品牌风格：使用品牌预设，统一语气、风格和视觉效果
图片生成：可为内容生成图片
定时发布：安排帖子在未来发布
双传输方式：支持 stdio（本地）和 HTTP 传输（Smithery／云端部署）
类型安全：使用 TypeScript 构建，并通过 Zod 进行验证

Claude Code 插件

**全新推出！**我们为 Claude Code 打造了官方插件，通过易用的命令和专用 AI Agent，让社交媒体内容创作更加轻松。

这是什么？

Claude Code 的 Hibiki 插件提供：

5 个斜杠命令：快速访问常用工作流
- /create-content - 在 AI 指导下创建适用于多个平台的帖子
- /schedule-post - 在互动效果最佳的时段安排帖子发布
- /view-brands - 浏览和管理品牌风格
- /manage-posts - 列出、筛选和管理所有帖子
- /preview-post - 预览针对不同平台格式化的内容
3 个专用 Agent：针对特定任务的专家级 AI 助手
- 内容创作者 - 擅长创作吸引人且针对平台优化的内容
- 品牌管理器 - 确保所有平台上的品牌风格一致
- 社交媒体优化专家 - 通过数据驱动的策略最大化触达范围和互动

使用插件快速开始

# Install the plugin
claude plugin install hibiki

# Set your API key
export HIBIKI_API_KEY="your-api-key-here"

# Start creating content
claude /create-content "Announcing our new feature"

# Or use an agent
claude "Content Creator, help me announce our product launch"

文档

完整的插件文档、安装说明和使用示例见 claude-code-plugin 目录。

参阅 claude-code-plugin/README.md，了解：

详细的安装说明
完整的命令参考
Agent 使用指南
高级工作流和示例
故障排除提示

安装

通过 MCP Registry 安装（推荐）

此服务已作为 io.github.gethibiki/mcp 发布到官方 MCP Registry。

可通过 Registry 网页界面浏览并安装，也可直接在 MCP 客户端中配置（请参阅下文的 MCP 客户端配置）。

通过 Smithery 部署（零配置）

最简单的入门方式是通过 Smithery，它提供：

一键安装 - 无需本地依赖或配置
自动更新 - 始终获取最新版本
安全托管 - 安全管理你的 API 密钥
交互式试用场 - 使用工具前先进行测试

从 Smithery 安装：

访问 Smithery 上的 Hibiki MCP 服务
点击“Install”
根据提示输入你的 Hibiki API 密钥
立即在 Claude Desktop 或其他 MCP 客户端中开始使用

全局安装（通过 npx）

npx @hibiki/mcp-server --api-key YOUR_API_KEY

本地开发

git clone https://github.com/gethibiki/mcp.git
cd hibiki-mcp
pnpm install
pnpm build

用法

前提条件

你需要一个 Hibiki API 密钥。请在以下位置生成：

生产环境：https://www.gethibiki.com/settings/api-keys
开发环境：http://localhost:3000/settings/api-keys

运行服务

Stdio 模式（本地）

这是与 Claude Desktop 等 MCP 客户端配合使用的默认模式：

npx @hibiki/mcp-server --api-key YOUR_API_KEY

也可以使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector npx @hibiki/mcp-server --api-key YOUR_API_KEY

使用自定义基础 URL：

npx @hibiki/mcp-server \
  --api-key YOUR_API_KEY \
  --base-url https://www.gethibiki.com

远程 HTTP 服务模式

在 HTTP 模式下运行服务，以用于云部署（例如 Smithery）或通过 HTTP 公开服务：

npx @hibiki/mcp-server --remote --api-key YOUR_API_KEY

服务将在端口 8081 上启动 HTTP 服务（可通过 PORT 环境变量配置），并提供：

/mcp - 主要 MCP 端点（POST）
/health - 健康检查端点（GET）

使用自定义配置：

PORT=3000 npx @hibiki/mcp-server \
  --remote \
  --api-key YOUR_API_KEY \
  --base-url https://www.gethibiki.com

注意： 在 HTTP 模式下，服务会实现 MCP Streamable HTTP transport，并为基于浏览器的客户端正确配置 CORS。

环境变量

除了命令行标志，你也可以使用环境变量：

用于 stdio 模式：

export HIBIKI_API_KEY=your_api_key
export HIBIKI_BASE_URL=http://localhost:3000
npx @hibiki/mcp-server

用于 HTTP 模式：

export HIBIKI_API_KEY=your_api_key
export HIBIKI_BASE_URL=https://www.gethibiki.com
export PORT=8081
npx @hibiki/mcp-server --remote

可用的环境变量：

HIBIKI_API_KEY - 你的 Hibiki API 密钥（仅限 stdio 模式；HTTP 模式使用查询参数）
HIBIKI_BASE_URL - Hibiki API 的基础 URL（默认值：https://www.gethibiki.com）
PORT - HTTP 服务端口（仅限 HTTP 模式，默认值：8081）

MCP 客户端配置

Claude Desktop

将以下内容添加到你的 Claude Desktop 配置文件中：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "hibiki": {
      "command": "npx",
      "args": [
        "@hibiki/mcp-server",
        "--api-key",
        "YOUR_API_KEY",
        "--base-url",
        "http://localhost:3000"
      ]
    }
  }
}

其他 MCP 客户端

对于支持 stdio 传输的其他 MCP 客户端，请使用类似配置，并设置相应的命令和参数。

可用工具

该服务提供 6 个用于管理 Hibiki 内容的工具：

工具	说明
`create-post`	创建经 AI 增强的多平台内容
`get-post`	按 ID 获取指定帖子
`get-all-posts`	分页列出帖子并进行筛选
`update-post`	更新现有帖子的标题、内容或状态
`get-brand-styles`	列出所有可用的品牌风格
`get-brand-style`	获取详细的品牌风格配置

create-post

创建新的内容帖子，并针对不同平台生成相应版本。

参数：

content（必填）：要增强的原始内容
platforms（必填）：目标平台数组
- 选项：twitter、instagram、linkedin、facebook、threads、blog、reddit
length（可选）：内容长度 - very-short、short、medium、long（默认值：medium）
createImage（可选）：生成图片（默认值：false）
createHashtags（可选）：生成话题标签（默认值：true）
scheduleTime（可选）：用于安排帖子发布时间的 ISO 8601 日期时间
postToSocialNetworks（可选）：立即发布到已连接的社交网络（默认值：false）
brandStyleId（可选）：要应用的品牌风格 UUID

示例：

{
  "content": "Just launched our new AI-powered content creation tool!",
  "platforms": ["twitter", "linkedin"],
  "length": "medium",
  "createImage": true,
  "createHashtags": true
}

返回：

帖子 ID
原始内容
针对各平台增强后的内容
生成的图片（如有请求）
各平台的话题标签
状态和时间戳

get-post

根据 ID 检索帖子。

参数：

postId（必填）：帖子的 UUID

示例：

{
  "postId": "123e4567-e89b-12d3-a456-426614174000"
}

返回：

完整的帖子数据
平台特定内容
生成的图片
状态和元数据

get-all-posts

分页并筛选所有帖子。

参数：

page（可选）：页码（默认：1）
limit（可选）：每页帖子数（默认：10）
status（可选）：按状态筛选 - draft、scheduled、published

示例：

{
  "page": 1,
  "limit": 20,
  "status": "published"
}

返回：

带有元数据的帖子数组
分页信息
总数

update-post

更新现有帖子。

参数：

postId（必填）：要更新的帖子的 UUID
title（可选）：帖子的标题
content（可选）：新内容
status（可选）：新状态 - draft、scheduled、published

示例：

{
  "postId": "123e4567-e89b-12d3-a456-426614174000",
  "title": "Updated Title",
  "status": "published"
}

返回：

更新后的帖子数据
确认消息

get-brand-styles

列出账户中所有可用的品牌样式。

参数： 无

返回：

包含 ID 和名称的品牌样式数组
样式元数据

get-brand-style

获取指定品牌样式的详细信息。

参数：

brandStyleId（必填）：品牌样式的 UUID

示例：

{
  "brandStyleId": "123e4567-e89b-12d3-a456-426614174000"
}

返回：

品牌样式名称和描述
调色板
字体排版设置
语调和风格指南
图像偏好设置

可用资源

post://{postId}

以 MCP 资源的形式访问帖子数据。

示例 URI：

post://123e4567-e89b-12d3-a456-426614174000

preview://{postId}/{platform}

获取特定平台的预览内容。

示例 URI：

preview://123e4567-e89b-12d3-a456-426614174000/twitter

开发

构建

pnpm build

本地运行

pnpm start -- --api-key YOUR_API_KEY

类型检查

pnpm typecheck

开发模式（监视）

pnpm dev

API 集成

MCP 服务连接到 Hibiki 的 REST API 端点：

POST /api/v1/posts - 创建新帖子
GET /api/v1/posts/{postId} - 检索单个帖子
GET /api/v1/posts - 分页列出帖子
PUT /api/v1/posts/{postId} - 更新现有帖子
GET /api/v1/brand-styles - 列出品牌样式
GET /api/v1/brand-styles/{brandStyleId} - 获取品牌样式详细信息

所有请求都需要在 X-API-Key 标头中提供身份验证密钥。

错误处理

服务器会针对常见问题提供详细的错误消息：

API 密钥无效：检查 API 密钥是否正确且处于启用状态
超出速率限制：等待一段时间后再发送其他请求
未找到帖子：确认帖子 ID 正确
参数无效：检查参数类型和格式
网络错误：确认基础 URL 和网络连接

示例

创建多平台帖子

// Using the create-post tool
{
  "content": "Excited to share our latest feature! \ud83d\ude80 AI-powered content optimization for all your social platforms.",
  "platforms": ["twitter", "linkedin", "instagram"],
  "length": "medium",
  "createImage": true,
  "createHashtags": true
}

安排帖子发布

{
  "content": "Join us for our product launch next week!",
  "platforms": ["twitter", "linkedin"],
  "scheduleTime": "2025-10-20T14:00:00Z",
  "createImage": true
}

检索帖子数据

// Using the get-post tool
{
  "postId": "123e4567-e89b-12d3-a456-426614174000"
}

访问资源

// Read post resource
{
  "uri": "post://123e4567-e89b-12d3-a456-426614174000"
}

// Read platform-specific preview
{
  "uri": "preview://123e4567-e89b-12d3-a456-426614174000/twitter"
}

在本地测试 HTTP 模式

以 HTTP 模式启动服务器：

npx @hibiki/mcp-server --remote --api-key YOUR_API_KEY

测试健康检查端点：

curl http://localhost:8081/health

使用 MCP Inspector 测试 MCP 端点：

npx @modelcontextprotocol/inspector http://localhost:8081/mcp?apiKey=YOUR_API_KEY

也可以搭配支持基于查询的配置的 Streamable HTTP MCP 客户端使用。

故障排除

服务器无法启动

检查是否已安装 Node.js 18+
确认 API 密钥有效
确保基础 URL 正确且可访问

工具调用失败

确认 API 密钥具有所需权限
检查是否已超出速率限制
确保帖子 ID 是有效的 UUID
确认平台名称拼写正确

无法访问 HTTP 模式

检查端口是否已被占用：lsof -i :8081（或你配置的 PORT）
确认防火墙设置允许连接
确保服务器进程使用 --remote 标志运行
检查服务器日志中是否有启动错误
确认 /health 端点有响应：curl http://localhost:8081/health
对于 Smithery 部署，请在 Smithery 控制面板中检查部署日志

Smithery 部署失败

确保 GitHub 仓库为公开仓库，或已连接到 Smithery
确认 smithery.yaml 和 Dockerfile 位于仓库根目录
在 Smithery 控制面板中查看构建日志，了解具体错误
确保 package.json 中声明了所有依赖项
尝试在本地构建 Docker 镜像：docker build -t hibiki-mcp .

贡献

欢迎贡献！请按以下步骤操作：

Fork 此仓库
创建功能分支（git checkout -b feature/amazing-feature）
提交更改（git commit -m 'Add amazing feature'）
推送到该分支（git push origin feature/amazing-feature）
创建 Pull Request

请确保你的代码：

遵循现有的 TypeScript 风格
包含适当的 Zod 验证模式
根据需要更新文档
通过类型检查（pnpm typecheck）
使用 console.error() 进行日志记录（不要使用 console.log()，否则会破坏 stdio 模式）

维护者须知

有关构建和发布更新的详细说明，请参阅 PUBLISHING.md。

支持

Smithery：https://smithery.ai/（一键部署）
MCP Registry：https://registry.modelcontextprotocol.io/servers/io.github.gethibiki/mcp
npm 包：https://www.npmjs.com/package/@hibiki/mcp-server
文档：https://docs.gethibiki.com
问题反馈：https://github.com/gethibiki/mcp/issues
API 参考：https://docs.gethibiki.com/api

许可证

MIT 许可证，详情请参阅 LICENSE 文件。

更新日志

v1.3.0 (2025-10-10)

新增：添加官方 Claude Code 插件
新增：5 个斜杠命令，简化内容工作流
新增：3 个专用 AI Agent（内容创作者、品牌经理、社交媒体优化器）
插件为所有 MCP 服务功能提供了易用的界面
提供全面的插件文档和使用示例
改善 Claude Code 用户的开发体验

v1.2.0 (2025-10-08)

新增：添加 HTTP 传输支持，适用于 Smithery 和云端部署
新增：实现 MCP Streamable HTTP，提供 /mcp 和 /health 端点
服务现在支持双传输模式：stdio（本地）和 HTTP（远程）
添加 Express 和 CORS 依赖项，用于 HTTP 服务
添加 Dockerfile，支持容器化部署
配置 Smithery 部署并设置正确的 HTTP 运行时
HTTP 模式支持通过查询参数进行配置
保持与 Claude Desktop 的 stdio 模式向后兼容

v1.0.3 (2025-10-08)

添加全面的发布文档（PUBLISHING.md）
移除配置中的所有调试控制台日志
改进贡献者指南

v1.0.2 (2025-10-08)

严重修复：移除会破坏 stdio JSON-RPC 协议的 console.log 语句
将调试输出改为写入 stderr，避免 JSON 解析错误
服务现在可与 Claude Desktop 和其他 MCP 客户端正常配合使用

v1.0.1 (2025-10-08)

发布到官方 MCP Registry
更新软件包元数据
完整的工具文档

v1.0.0 (2025-10-08)

首次发布
支持 6 个 Hibiki API 工具
支持多平台内容创作
集成品牌风格

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

thoth-mcp

关于 thoth-mcp

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

Hibiki MCP 服务

快速开始

目录

功能

Claude Code 插件

这是什么？

使用插件快速开始

文档

安装

通过 MCP Registry 安装（推荐）

通过 Smithery 部署（零配置）

全局安装（通过 npx）

本地开发

用法

前提条件

运行服务

Stdio 模式（本地）

远程 HTTP 服务模式

环境变量

MCP 客户端配置

Claude Desktop

其他 MCP 客户端

可用工具

create-post

get-post

get-all-posts

update-post

get-brand-styles

get-brand-style

可用资源

post://{postId}

preview://{postId}/{platform}

开发

构建

本地运行

类型检查

开发模式（监视）

API 集成

错误处理

示例

创建多平台帖子

安排帖子发布

检索帖子数据

访问资源

在本地测试 HTTP 模式

故障排除

服务器无法启动

工具调用失败

无法访问 HTTP 模式

Smithery 部署失败

贡献

维护者须知

支持

许可证

更新日志

v1.3.0 (2025-10-10)

v1.2.0 (2025-10-08)

v1.0.3 (2025-10-08)

v1.0.2 (2025-10-08)

v1.0.1 (2025-10-08)

v1.0.0 (2025-10-08)

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？