🚀 Dev.to MCP Server

🚀 Dev.to MCP サーバー

---

Dev.to API 向けの Model Context Protocol (MCP) サーバーの実装です。Dev.to のコンテンツを検索、閲覧、読解、作成する機能を提供します。

---

✨ 機能

機能	説明
🔍 Browse Latest Articles	Dev.to の最新記事を取得します
🌟 Browse Popular Articles	人気記事を取得します
🏷️ Browse by Tag	特定のタグが付いた記事を取得します
📚 Browse by Title	特定のタイトルの記事を取得します
📖 Read Article	特定の記事の詳細情報を取得します
👤 User Profile	Dev.to ユーザーの情報を取得します
🔎 Search Articles	キーワードを使って記事を検索します
👤 Search Articles by User	特定のユーザーによるすべての記事を検索します
📝 Get Article by ID	特定の記事の詳細情報を取得します
📝 Get Article by Title	特定の記事の詳細情報を取得します
🧠 Analyze Article	特定の記事を分析します（プロンプトベース、要約を出力）
🧠 Analyze User Profile	特定のユーザープロフィールを分析します（プロンプトベース、要約を出力）
📝 Create Article	新しい記事を作成して公開します
✏️ Update Article	既存の記事を更新します
📝 Update Article by Title	タイトルで既存の記事を更新します（ID に解決）
📜 List My Articles	自分が公開した記事を一覧表示します
📝 List My Draft Articles	自分の下書き記事を一覧表示します
📝 List My Unpublished Articles	自分の未公開記事を一覧表示します
📝 List My Scheduled Articles	自分の予約済み記事を一覧表示します
🧑‍💻 Publish Article by ID	ID を指定して自分の記事を公開します
📝 Publish Article by Title	タイトルを指定して自分の記事を公開します
🧑‍💻 Unpublish Article by ID	ID を指定して自分の記事を非公開にします
📝 Unpublish Article by Title	タイトルを指定して自分の記事を非公開にします
📝 Delete Article	自分の記事を削除します

---

🧠 分析ツール

機能	説明
🧠 Analyze Article	特定の記事を分析します（プロンプトベース、要約を出力）
🧠 Analyze User Profile	特定のユーザープロフィールを分析します（プロンプトベース、要約を出力）

注： 分析ツールは、生データではなく、自然言語による要約と洞察を提供します。

---

📝 ライセンス

このプロジェクトは、GNU Affero General Public License v3.0 (AGPLv3) の下でライセンスされています。

商用利用に関する警告

このコードを何らかの形で他者に有償サービスとして使用または提供する場合、たとえコード自体に対して料金を請求しない場合でも、私に連絡して許可を得る必要があります（これは YOU Smithery/Glama、または類似するサービスすべてを対象とします）。許可は、適切なライセンス料のお支払い後にのみ付与されます。コード自体の使用料を請求しておらず、インフラを提供しているだけだとしても、MY コードを使って YOUR サービスを実現していることになります。これは本質的な依存関係であり、必ずライセンスを取得する必要があります。

企業・個人を問わず、ほかの皆さまのお役に立てれば幸いです。ぜひご活用ください。

---

⚙️ サーバーの設定

サーバーは、次の環境変数を使用して設定できます。

環境変数	説明	デフォルト
PORT	サーバーを実行するポート	8000
LOG_LEVEL	ログレベル（INFO、DEBUG など）	INFO

---

🔐 クライアント認証

認証が必要な操作を行うには、各クライアントがそれぞれ Dev.to API キーを用意する必要があります。クライアントの MCP サーバー設定で、API キーを環境変数として指定することで安全に設定できます。

注： キーは、MCP クライアント設定の環境変数セクションで DEVTO_API_KEY として指定してください。

---

🚀 はじめに

🐳 Docker で実行する

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

git clone https://github.com/rawveg/devtomcp.git
cd devtomcp

2. Docker Compose でビルドして実行します：

docker-compose up --build

サーバーは http://localhost:8000 で利用でき、SSE エンドポイントは http://localhost:8000/sse です。

---

🛠️ MCP ツール

コンテンツの分析

• analyse_article - 特定の記事を分析します
• analyse_user_profile - 特定のユーザーを分析します

コンテンツの閲覧

• browse_latest_articles() - Dev.to の最新記事を取得します
• browse_popular_articles() - 人気の記事を取得します
• browse_articles_by_tag(tag) - 特定のタグが付いた記事を取得します

コンテンツの読み取り

• get_article(id) - 特定の記事の詳細情報を取得します
• get_user_profile(username) - Dev.to ユーザーの情報を取得します

コンテンツの検索

• search_articles(query, page=1) - キーワードを使って記事を検索します
• search_articles_by_user(username, page=1) - 特定のユーザーによるすべての記事を検索します

コンテンツの管理（認証が必要）

• list_my_articles(page=1, per_page=30) - 自分が公開した記事を一覧表示します
• list_my_draft_articles(page=1, per_page=30) - 自分の下書き記事を一覧表示します
• list_my_unpublished_articles(page=1, per_page=30) - 自分の未公開記事を一覧表示します
• create_article(title, content, tags="", published=False) - 新しい記事を作成します
• update_article(id, title=None, content=None, tags=None, published=None) - 既存の記事を更新します
• delete_article(id) - 既存の記事を削除します
• publish_article_by_id(id) - ID を指定して自分の記事を公開します
• publish_article_by_title(title) - タイトルを指定して自分の記事を公開します
• unpublish_article_by_id(id) - ID を指定して自分の記事を非公開にします
• unpublish_article_by_title(title) - タイトルを指定して自分の記事を非公開にします
• update_article_by_title(title, new_title=None, content=None, tags=None, published=None) - タイトルを指定して既存の記事を更新します（ID に解決します）

---

🌐 REST API と OpenAPI ツールサーバー

Dev.to MCP Server は、デュアルモードでの動作に対応しました。

モード	説明
🟢 SSE/MCP	Model Context Protocol（MCP）を使用した、LLM／エージェント連携向け
🟦 REST/OpenAPI	直接 HTTP アクセス、OpenAPI ツールランナー、OpenAI 互換ツール向け

🚦 モードの切り替え

.env ファイルでモードを設定します。

SERVER_MODE=sse   # For SSE/MCP (default)
# or
SERVER_MODE=rest  # For REST API & OpenAPI toolserver

🔑 REST モードでの認証

• Dev.to API キーを Bearer トークンとして Authorization ヘッダーに指定します。

  Authorization: Bearer YOUR_DEVTO_API_KEY
  

• REST モードでは、.env に DEVTO_API_KEY を設定する必要はありません。

📖 OpenAPI と Swagger UI

• インタラクティブなドキュメント：http://localhost:8000/docs
• OpenAPI スキーマ：http://localhost:8000/openapi.json
• OpenAI の関数呼び出し、LangChain、その他の OpenAPI ツールランナーと完全に互換性があります。

🧑‍💻 例：自分の記事を一覧表示する（REST）

curl -X GET "http://localhost:8000/list_my_articles?page=1&per_page=30&max_pages=10" \
  -H "Authorization: Bearer YOUR_DEVTO_API_KEY"

🛠️ REST エンドポイント

• 主要なツールはすべて REST エンドポイントとして利用できます（詳細は /docs を参照してください）。
• 各エンドポイントには、見つけやすいように詳細な OpenAPI メタデータ、使用例、タグが含まれています。
• update_article_by_title - タイトルを指定して自分の記事を更新します（ID を解決します）。

🤖 これが重要な理由

• 1 つのコードベースで、従来の REST API、OpenAPI ツールサーバー、LLM／エージェント向けツールプロバイダーとして利用できます。
• OpenAI、LangChain、および OpenAPI 互換のあらゆるクライアントにプラグアンドプレイで接続できます。
• 美しくインタラクティブなドキュメントをすぐに利用できます。

---

🖥️ クライアントの設定

Claude Desktop の設定

Claude Desktop の config.json に MCP サーバーを追加します。

{
  "mcpServers": {
    "devto": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Cursor の設定

Cursor の設定に MCP サーバーを追加します。

{
  "mcpServers": {
    "devto": {
      "url": "http://localhost:8000/sse"
    }
  }
}

注記

Windsurf IDE by Codium など、一部のクライアントでは url の代わりに serverUrl を使用する必要がある場合があります。

Python によるプログラムからのアクセス

import asyncio
import os
from fastmcp.client import Client

async def main():
    # Set environment variable for authentication
    os.environ["DEVTO_API_KEY"] = "your_dev_to_api_key_here"
    
    # Connect to the MCP server
    client = Client("http://localhost:8000/sse")
    
    # Use the client
    async with client:
        # Get popular articles
        results = await client.call_tool("browse_popular_articles", {})
        print(results)

if __name__ == "__main__":
    asyncio.run(main())

---

☁️ Google Cloud Run へのデプロイ

Google Cloud Run にデプロイする手順：

1. Google Cloud Run クイックスタートに従って、環境を設定します。

2. Dev.to API キーをシークレットとして設定します。

   gcloud secrets create devto-api-key --data-file=- <<< "your_api_key_here"
   

3. シークレットをマウントした状態で SSE モードでデプロイします。

   gcloud run deploy devtomcp \
      --source . \
      --platform managed \
      --allow-unauthenticated \
      --region [REGION] \
      --set-env-vars="LOG_LEVEL=<<LOG_LEVEL>>" \
      --set-env-vars="DEVTO_API_KEY=<<DEVTO_API_KEY>>" \
      --set-env-vars="SERVER_MODE=sse" \
      --set-env-vars="DEVTO_API_BASE_URL=<<DEVTO_API_BASE_URL>>" \
      --format="json"
   

   環境変数

   変数	説明	デフォルト
   LOG_LEVEL	ログレベル（INFO、DEBUG など）	INFO
   DEVTO_API_KEY	Dev.to API キー	None
   DEVTO_API_BASE_URL	Dev.to API のベース URL	https://dev.to/api
   SERVER_MODE	デプロイするサーバーモード	sse

   .env ファイルはコンテナにマウントされないため、これらの変数は gcloud run deploy のコマンドラインで設定する必要があります。

   OpenAPI ツールを使用して REST モードでデプロイする場合：

   gcloud run deploy devtomcp \
      --source . \
      --platform managed \
      --allow-unauthenticated \
      --region [REGION] \
      --set-env-vars="LOG_LEVEL=<<LOG_LEVEL>>" \
      --set-env-vars="SERVER_MODE=rest" \
      --set-env-vars="DEVTO_API_BASE_URL=<<DEVTO_API_BASE_URL>>" \
      --format="json"
   

   環境変数

   変数	説明	デフォルト
   LOG_LEVEL	ログレベル（INFO、DEBUG など）	INFO
   SERVER_MODE	デプロイするサーバーモード	rest
   DEVTO_API_BASE_URL	Dev.to API のベース URL	https://dev.to/api

   .env ファイルはコンテナにマウントされないため、これらの変数は gcloud run deploy のコマンドラインで設定する必要があります。

リージョンの選択 リージョンは、関連付けられたプロジェクトのリージョンに応じて選択してください。利用可能なリージョンの一覧はこちらで確認できます。

⚠️ セキュリティ警告 - SSE モード：

• --allow-unauthenticated フラグを指定すると、サーバーがパブリックにアクセス可能になります。

• API キーを使用する単一ユーザー向けサーバーであるため、追加のセキュリティ対策を必ず実施してください。

  • Cloud Run 認証を使用します。
  • Identity-Aware Proxy（IAP）を設定します。
  • VPC Service Controlsを設定します。
  • Ingress Controlsを使用します。

• REST モードでデプロイする場合（Cloud Run では推奨）、このモードではサーバーへの各リクエストに Authorization Bearer Token Authorization: Bearer <<your_dev_to_api_key_here>> を付与する必要があり、破壊的な操作へのアクセスがただちに制限されるため、上記のセキュリティ上の考慮事項は該当しません。

セキュリティ設定の詳細な手順については、GCP_DEPLOYMENT.mdを参照してください。

---

⚠️ エラー処理

サーバーは標準の MCP エラーレスポンスを返します。

{
  "status": "error",
  "message": "Error description",
  "code": 401
}

一般的なエラーコード：

• 401：認証に失敗しました（API キーがない、または無効です）
• 404：リソースが見つかりません
• 422：パラメーターが無効です
• 500：サーバーエラー

---

🔒 セキュリティに関する考慮事項

• サーバーでは API キーの設定に環境変数を使用し、適切なセキュリティ分離を実現しています
• 各クライアント接続では、それぞれに設定された API キーを使用します
• API 認証情報の処理はすべてサーバー側で行われます
• 本番環境では HTTPS を使用してください
• クラウド環境へのデプロイでは、安全なシークレット管理を使用してください

---

🤝 貢献

皆さまからの貢献を歓迎します！お気軽にプルリクエストを送信してください。

---

🙏 謝辞

• Dev.to API ドキュメント
• Model Context Protocol

---

📬 お問い合わせ

質問、提案、サポートについては、イシューを作成してください。