Hashnode MCP Server

🚀 Hashnode MCP Server

Hashnode APIとやり取りするためのモデルコンテキストプロトコル（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  # Windowsの場合は: .venv\Scripts\activate を使用
   

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

   pip install -r requirements.txt
   

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

   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サーバーの使用方法

サーバーが起動したら、Model Context Protocol (MCP) をサポートするAIアシスタント（Claudeなど）で使用できます。アシスタントはサーバーが提供するツールを使用して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: 現時点ではClaude DesktopはLinuxでは利用できません（代わりに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 ファイルを参照してください。

🌐 GitHubリポジトリ

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

🔧 技術詳細

このプロジェクトはクリーンでモジュール化された構造で組織されています：

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

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

🚀 将来の機能拡張

予定されている将来の開発には以下が含まれます：

• 追加のHashnode機能（コメント、シリーズ、ニュースレター）
• 分析機能の統合
• コンテンツの最適化
• マルチユーザーサポート
• ウェブフックサポート

🙏 謝辞

• Hashnode がAPIを提供してくれたことに感謝します。
• Model Context Protocol (MCP) がサーバーフレームワークを提供してくれたことに感謝します。
• このプロジェクトは MCP Review によって認定されています。