thoth-mcp

ローカル

github.com/perminder-klairビジネス・マーケティング211 週間前に更新

リポジトリ

thoth-mcp について

thoth-mcpは、Hibiki APIを通じてコンテンツを作成・管理するMCPサーバーです。AIアシスタントやコンテンツチーム向けに、SNSやブログ用の投稿、ブランドスタイル、画像生成、予約投稿を提供します。

主な機能

01複数プラットフォーム向けコンテンツ生成
02ブランドスタイルの適用
03画像とハッシュタグの任意生成
04投稿の予約と管理
05ページングや絞り込みによる投稿取得

活用シーン

01プラットフォーム別のキャンペーン投稿の下書き
02SNS投稿の予約公開
03既存投稿の確認や更新
04ブランドガイドラインに沿ったコンテンツ作成

MCP 対応

6つのツールで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 コンテンツ作成プラットフォーム向けの Model Context Protocol（MCP）サーバーです。このサーバーを使うと、AI アシスタントやツールから Hibiki の API を通じてコンテンツを作成、取得できます。

✨ 新機能： スラッシュコマンドと専用 AI エージェントを備えた Claude Code プラグインが利用可能になり、コンテンツ作成ワークフローを効率化できます！

クイックスタート

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

# Or configure in Claude Desktop (see Configuration below)

API キーは www.gethibiki.com/settings/api-keys で取得できます。

機能

コンテンツの作成：AI による強化で、プラットフォームに最適化されたコンテンツを生成します
投稿の取得と管理：ページネーションを使って投稿データを取得、一覧表示、更新します
複数プラットフォームへの対応：Twitter、Instagram、LinkedIn、Facebook、Threads、Blog、Reddit
ブランドスタイル：ブランドプリセットを使って、一貫した口調、トーン、ビジュアルスタイルを適用します
画像生成：コンテンツ用の画像を任意で生成できます
スケジュール設定：投稿を将来の公開日時に設定できます
デュアルトランスポート：stdio（ローカル）と HTTP トランスポート（Smithery／クラウドデプロイ）の両方に対応しています
型安全：TypeScript と Zod による検証を使用して構築されています

Claude Code プラグイン

新機能！ 使いやすいコマンドと専用 AI エージェントにより、ソーシャルメディアのコンテンツ作成をさらに簡単にする公式 Claude Code プラグインを作成しました。

これは何ですか？

Claude Code 用の Hibiki プラグインでは、以下を利用できます。

5 つのスラッシュコマンド：よく使うワークフローにすばやくアクセスできます
- /create-content - AI のガイダンスに沿って複数プラットフォーム向けの投稿を作成
- /schedule-post - エンゲージメントに最適な時間に投稿を予約
- /view-brands - ブランドスタイルを閲覧、管理
- /manage-posts - すべての投稿を一覧表示、絞り込み、管理
- /preview-post - プラットフォームごとのコンテンツの書式をプレビュー
3 つの専用エージェント：特定のタスクに対応するエキスパート 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 をご覧ください。

詳細なインストール手順
コマンドの完全なリファレンス
エージェントの使用ガイド
高度なワークフローと使用例
トラブルシューティングのヒント

インストール

MCP レジストリ経由（推奨）

このサーバーは、公式の MCP Registry に io.github.gethibiki/mcp として公開されています。

レジストリのウェブインターフェースから参照してインストールするか、MCP クライアントで直接設定してください（下記のMCP クライアントの設定を参照）。

Smithery 経由（セットアップ不要のデプロイ）

最も簡単に始めるには、Smithery を利用します。次の機能が提供されています。

ワンクリックインストール - ローカルの依存関係や設定は不要です
自動更新 - 常に最新バージョンを利用できます
安全なホスティング - API キーは安全に管理されます
インタラクティブなプレイグラウンド - ツールを使用する前にテストできます

Smithery からインストールするには：

Smithery の Hibiki MCP Server にアクセスします
「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 サーバーモード

クラウドへのデプロイ（Smithery など）や、HTTP 経由でサーバーを公開する場合は、HTTP モードでサーバーを実行します。

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

サーバーはポート 8081（環境変数 PORT で設定可能）で HTTP サーバーを起動し、次のエンドポイントを提供します。

/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 クライアントでは、適切なコマンドと引数を指定して、同様の設定を使用します。

利用可能なツール

このサーバーは、Hibiki のコンテンツを管理するための 6 つのツールを提供します。

ツール	説明
`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（任意）：1 ページあたりの投稿数（デフォルト：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 .

コントリビューション

コントリビューションを歓迎します。以下の手順に従ってください。

リポジトリをフォークします
フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
変更をコミットします（git commit -m 'Add amazing feature'）
ブランチにプッシュします（git push origin feature/amazing-feature）
プルリクエストを作成します

コードについて、以下を確認してください。

既存の TypeScript スタイルに従っていること
バリデーションに適切な Zod スキーマを含めていること
必要に応じてドキュメントを更新していること
型チェックに合格すること（pnpm typecheck）
ログ出力には console.log() ではなく 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 の詳細については、LICENSE ファイルを参照してください。

変更履歴

v1.3.0 (2025-10-10)

新機能：公式 Claude Code プラグインを追加
新機能：コンテンツのワークフローを効率化する 5 つのスラッシュコマンド
新機能：3 つの特化型 AI エージェント（コンテンツクリエーター、ブランドマネージャー、ソーシャルメディアオプティマイザー）
プラグインにより、すべての MCP サーバー機能を使いやすいインターフェースから利用可能
包括的なプラグインドキュメントと使用例
Claude Code ユーザーの開発者体験を向上

v1.2.0 (2025-10-08)

新機能：Smithery およびクラウドデプロイ向けに HTTP トランスポートのサポートを追加
新機能：/mcp と /health エンドポイントを備えた MCP Streamable HTTP を実装
サーバーが stdio（ローカル）と HTTP（リモート）の 2 つのトランスポートモードに対応
HTTP サーバー向けに Express と CORS の依存関係を追加
コンテナ化したデプロイ向けに Dockerfile を追加
適切な HTTP ランタイムを使用する Smithery デプロイ向けの設定
HTTP モードでクエリパラメーターによる設定に対応
Claude Desktop 向けの stdio モードとの後方互換性を維持

v1.0.3 (2025-10-08)

公開手順に関する包括的なドキュメント（PUBLISHING.md）を追加
config からデバッグ用の console ログをすべて削除
コントリビューター向けガイドラインを改善

v1.0.2 (2025-10-08)

重大な修正：stdio JSON-RPC プロトコルを妨げていた console.log 文を削除
JSON の解析エラーを防ぐため、デバッグ出力を stderr に変更
サーバーが Claude Desktop やその他の MCP クライアントで正しく動作するように修正

v1.0.1 (2025-10-08)

公式 MCP Registry に公開
パッケージのメタデータを更新
ツールのドキュメントを完備

v1.0.0 (2025-10-08)

初回リリース
6 つの Hibiki API ツールに対応
マルチプラットフォームのコンテンツ作成
ブランドスタイルの統合

Markdown 対応

ログインしてコメント

基本情報

作者: zeiq-co
言語: node
バージョン: 1.0.2
トランスポート: stdio
掲載日: 2025年10月8日
最終更新: 11 週間前
公式 Registry: io.github.zeiq-co/thoth-mcp

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

thoth-mcp

thoth-mcp について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

Hibiki MCP サーバー

クイックスタート

目次

機能

Claude Code プラグイン

これは何ですか？

プラグインのクイックスタート

ドキュメント

インストール

MCP レジストリ経由（推奨）

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 にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？