Hashnode MCP Server

Hashnode MCP サーバー

Hashnode API と連携するための Model Context Protocol（MCP）サーバーです。このサーバーは、Hashnode のコンテンツにプログラムからアクセスし、検索するためのツールを提供します。

デモ

• 記事の作成
• 記事の更新

機能

• 新しい記事の作成と公開
• 既存の記事の更新
• キーワードによる記事の検索
• 記事の詳細の取得
• ユーザー情報の取得
• パブリケーションから最新の記事を取得

インストール

1. リポジトリをクローンします：

   git clone https://github.com/sbmagar13/hashnode-mcp-server.git
   cd hashnode-mcp-server
   

2. 仮想環境を作成して有効化します：

   python -m venv .venv
   source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate
   

3. 依存関係をインストールします：

   pip install -r requirements.txt
   

4. ルートディレクトリに Hashnode API 認証情報を含む .env ファイルを作成します：

   HASHNODE_PERSONAL_ACCESS_TOKEN=your_personal_access_token
   HASHNODE_API_URL=https://gql.hashnode.com
   

使用方法

サーバーの起動

サーバーを実行する方法は 2 つあります：

方法 1：サーバーを手動で実行する

python run_server.py

または、ルートファイルを直接使用します：

python mcp_server.py

サーバーが起動し、AI アシスタントからの接続を待ち受けます。デフォルトでは、Server-Sent Events（SSE）トランスポートプロトコルを使用して localhost:8000 で実行されます。

方法 2：MCP 統合に自動で処理させる

Claude Desktop または Cline VSCode 拡張機能で正しく設定すると、MCP 統合がサーバープロセスを自動的に起動し、管理します。

ファイル構成に関する重要な注意

Claude Desktop または Cline VSCode 拡張機能で MCP サーバーを設定する際は、hashnode_mcp ディレクトリ内のファイルではなく、ルートの mcp_server.py ファイルを直接使用してください。hashnode_mcp ディレクトリは、主にパッケージ化のためのものです。

利用可能なツール

サーバーは以下のツールを提供します：

• test_api_connection(): Hashnode API への接続をテストします
• create_article(title, body_markdown, tags="", published=False): Hashnode で新しい記事を作成して公開します
• update_article(article_id, title=None, body_markdown=None, tags=None, published=None): Hashnode の既存の記事を更新します
• get_latest_articles(hostname, limit=10): ホスト名を指定して、Hashnode のパブリケーションから最新の記事を取得します
• search_articles(query, page=1): Hashnode の記事を検索します
• get_article_details(article_id): 特定の記事の詳細情報を取得します
• get_user_info(username): Hashnode ユーザーの情報を取得します

MCP サーバーの使用

サーバーの実行中は、Claude など、Model Context Protocol（MCP）に対応した AI アシスタントで使用できます。アシスタントは、サーバーが提供するツールを使って Hashnode API と連携できます。

ツールでは、以下を実行できます：

• API 接続のテスト
• 新しい記事の作成と公開
• 既存の記事の更新
• パブリケーションから最新の記事を取得
• 記事の検索
• 特定の記事に関する詳細情報の取得
• ユーザー情報の取得

Claude Desktop と Cline VSCode 拡張機能での MCP の設定

Cline VSCode 拡張機能

1. Cline の MCP 設定ファイルを開きます：

   • Windows：%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
   • macOS：~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings\cline_mcp_settings.json
   • Linux：Unfortunately, Claude Desktop is not available for Linux as of now（代わりに Cline 拡張機能を使用できます）

2. Hashnode MCP サーバーの設定を追加します：

   {
     "mcpServers": {
       "hashnode": {
         "command": "/path/to/your/venv/bin/python",
         "args": [
           "/path/to/your/hashnode-mcp-server/mcp_server.py"
         ],
         "env": {
           "HASHNODE_PERSONAL_ACCESS_TOKEN": "your-personal-access-token"
         }
       }
     }
   }
   

Claude Desktop

1. 設定ファイルを開きます：

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

2. 上記と同じ形式で Hashnode MCP サーバーの設定を追加します。

接続の問題のトラブルシューティング

接続の問題が発生した場合は、以下を確認してください。

• サーバーが稼働していることを確認します
• 設定内のパスを確認します
• 環境変数が正しく設定されていることを確認します
• サーバーログにエラーメッセージがないか確認します
• MCP サーバーと Claude アプリケーションの両方を再起動してみます

環境変数

• HASHNODE_PERSONAL_ACCESS_TOKEN：Hashnode の個人用アクセストークン
• HASHNODE_API_URL：Hashnode GraphQL API の URL（デフォルト：https://gql.hashnode.com）

コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

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

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。

GitHub リポジトリ

このプロジェクトのソースコードは GitHub で公開されています。 https://github.com/sbmagar13/hashnode-mcp-server

技術アーキテクチャ

このプロジェクトは、すっきりとしたモジュール構成になっています。

• mcp_server.py：直接実行できるルートサーバーの実装
• hashnode_mcp/：モジュール化された機能を含むコアパッケージ
  • mcp_server.py：サーバー実装のパッケージ版
  • utils.py：レスポンスと GraphQL クエリのフォーマット用ユーティリティ関数
• run_server.py：パッケージ版を使用してサーバーを実行するためのエントリーポイント

サーバーは、効率的な API 通信のために Python の asyncio および httpx ライブラリを使用した非同期プログラミングを採用しています。GraphQL のクエリとミューテーションは定数として定義されているため、保守や更新が容易です。

今後の機能強化

今後予定されている開発内容は以下のとおりです。

• Hashnode の追加機能（コメント、シリーズ、ニュースレター）
• アナリティクスの統合
• コンテンツの最適化
• マルチユーザー対応
• Webhook のサポート

謝辞

• API を提供している Hashnode に感謝します
• サーバーフレームワークを提供している Model Context Protocol (MCP) に感謝します
• このプロジェクトは MCP Review による認定を受けています