The Qiita MCP Server is a Model Context Protocol server that provides comprehensive access to Qiita and Qiita Team articles through various search and retrieval tools.
Core Capabilities:
Search articles - Search by query string or retrieve recent articles, with pagination support (1-100 items per page)
Get specific articles - Retrieve detailed information about an article using its ID
Browse by tags - Find articles with specific tags (e.g., 'Python', 'JavaScript') with pagination
Browse by user - Get all articles written by a specific user with pagination
Explore tags - Retrieve a list of tags used in Qiita, sortable by usage count or name
Read comments - Access comments posted on a specific article
View user bookmarks - Retrieve articles that a user has stocked (bookmarked) with pagination
Additional Features:
Supports both public Qiita and private Qiita Team instances
Optional authentication with access tokens for higher rate limits
Type-safe validation using Zod
SSE (Server-Sent Events) communication for integration with Claude Desktop
Provides tools for searching and viewing Qiita articles, retrieving articles by tag or user, managing bookmarked articles (stocks), fetching comments, and accessing Qiita Team content.
Qiita MCP Server
Qiita および Qiita Team の記事検索・閲覧機能を提供する MCP (Model Context Protocol) サーバー。
特徴
📖 記事の検索・閲覧
🏷️ タグによる絞り込み
👤 ユーザー別記事取得
💬 コメント取得
⭐ ストック(ブックマーク)記事の取得
🔒 Qiita Team 対応
⚡ Hono による高速なルーティング
✅ Zod による型安全なバリデーション
技術スタック
Hono: 軽量で高速な Web フレームワーク
Zod: TypeScript ファーストなスキーマバリデーション
MCP SDK: Model Context Protocol の公式 SDK
TypeScript: 型安全な開発
仕様書
詳細な仕様は docs/specification.md を参照してください。
インストール
起動
サーバーの起動
デフォルトでは http://localhost:3000 で起動します。
環境変数
ポート設定(オプション)
Qiita アクセストークン(オプション)
認証なしでも公開記事は閲覧できますが、レート制限が厳しくなります。 アクセストークンを設定することを推奨します。
アクセストークンは Qiita の設定ページ で取得できます。
Qiita Team(オプション)
Qiita Team を使用する場合は、チーム名を設定します。
環境変数を設定して起動
Claude Desktop での設定
本サーバーは SSE (Server-Sent Events) 方式で動作します。
Claude Desktop の設定ファイルに以下を追加します。
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
重要: Claude Desktop から接続する前に、サーバーを起動しておく必要があります。
サーバーを起動してから Claude Desktop を起動、またはリロードしてください。
環境変数付きで起動する場合
別のターミナルウィンドウで以下のコマンドを実行してサーバーを起動します:
Qiita Team を使用する場合:
提供されるツール
search_items
記事を検索します。
パラメータ:
query(string, optional): 検索クエリpage(number, optional): ページ番号(1-100、デフォルト: 1)per_page(number, optional): 1ページあたりの件数(1-100、デフォルト: 20)
使用例:
get_item
特定の記事を取得します。
パラメータ:
item_id(string, required): 記事ID
使用例:
get_items_by_tag
特定のタグが付いた記事を取得します。
パラメータ:
tag_id(string, required): タグIDpage(number, optional): ページ番号per_page(number, optional): 1ページあたりの件数
使用例:
get_items_by_user
特定のユーザーの記事を取得します。
パラメータ:
user_id(string, required): ユーザーIDpage(number, optional): ページ番号per_page(number, optional): 1ページあたりの件数
使用例:
get_tags
タグ一覧を取得します。
パラメータ:
page(number, optional): ページ番号per_page(number, optional): 1ページあたりの件数sort(string, optional): ソート順("count" または "name")
使用例:
get_item_comments
記事のコメントを取得します。
パラメータ:
item_id(string, required): 記事ID
使用例:
get_user_stocks
ユーザーがストックした記事を取得します。
パラメータ:
user_id(string, required): ユーザーIDpage(number, optional): ページ番号per_page(number, optional): 1ページあたりの件数
使用例:
開発
ライセンス
MIT