Qiita Researcher

Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

ファイルが存在しない場合は新規作成してください。

トークンなし: 60リクエスト/時 トークンあり: 1000リクエスト/時

1. Qiitaトークン設定にアクセス
2. 読み取り権限で新しいトークンを作成
3. トークンを上記のQIITA_ACCESS_TOKENに貼り付け

設定ファイル

~/.claude.json を編集：

{
  "mcpServers": {
    "qiita-researcher": {
      "command": "npx",
      "args": ["-y", "mcp-server-qiita-researcher"],
      "env": {
        "QIITA_ACCESS_TOKEN": ""
      }
    }
  }
}

起動

claude

Claudeで試してみる：

Qiitaで「React」のトレンドを教えて

✅ 3つのツール（search_articles、get_tech_trends、read_article_smart）が使えるようになります

コードを修正・カスタマイズしたい場合：

クローンとビルド

git clone https://github.com/yourusername/mcp-server-qiita-researcher.git
cd mcp-server-qiita-researcher
npm install
npm run build

設定ファイル

npxの代わりにnodeを使用：

{
  "mcpServers": {
    "qiita-researcher": {
      "command": "node",
      "args": ["/絶対パス/mcp-server-qiita-researcher/build/index.js"],
      "env": {
        "QIITA_ACCESS_TOKEN": ""
      }
    }
  }
}

絶対パスの確認:

cd mcp-server-qiita-researcher
pwd

開発コマンド

npm run dev    # ウォッチモード（変更を自動検知）
npm run build  # ビルド
npm start      # 起動確認

プロジェクト構造

src/
├── index.ts              # MCPサーバーエントリーポイント
├── qiitaClient.ts        # Qiita APIクライアント
├── types.ts              # Zodスキーマ + TypeScript型
├── constants.ts          # 設定
└── utils/
    ├── dateUtils.ts      # 日付計算
    ├── queryBuilder.ts   # クエリ構築
    ├── htmlCleaner.ts    # HTMLクリーンアップ（cheerio）
    └── textTruncator.ts  # スマート切り詰め

search_articles - 品質重視の検索

{
  "query": "React hooks",           // 検索キーワード
  "sort": "stock",                  // "rel" (関連度順) | "stock" (ストック数順)
  "threshold_stocks": 20            // 最小ストック数（デフォルト: 10）
}

動作:

• 低品質記事を自動除外
• トークン効率の良いクリーンなサマリーを返却

get_tech_trends - トレンド発見

{
  "scope": "weekly",                // "weekly" | "monthly" | "new_arrival"
  "topic": "React"                  // オプション：タグで絞り込み
}

動作:

• 日付範囲を自動計算
• 適切なストック閾値を適用
• 複雑なクエリ構文なしでトレンド記事を取得

read_article_smart ⭐ - 記事+コメント一括取得

{
  "item_id": "abc123def456"         // URLの末尾ID
}

キラー機能:

• 記事本文+リアクション数TOP3コメントを並列取得
• 記事だけでは得られないコミュニティの知見を提供
• 20,000文字を超える場合のスマート切り詰め

取得内容:

• 記事メタデータ（タイトル、著者、作成日、ストック数、いいね数、タグ）
• クリーンな記事本文（HTML除去済み）
• リアクション数順のトップ3コメント

ツールが認識されない

npx版

# 動作確認
npx -y mcp-server-qiita-researcher

# キャッシュクリア
npm cache clean --force

期待される出力:

Qiita Researcher MCP Server started successfully
Version: 1.0.0

ソースコード版

# ビルド確認
npm run build
ls build/index.js

# パス確認
pwd  # この出力が設定ファイルのパスと一致するか確認

→ Claudeを完全再起動（すべてのウィンドウを閉じる）

よくあるエラー

「Qiita APIのレート制限に達しました」

原因: リクエスト制限に到達

解決策:

1. エラーメッセージに表示された時間まで待つ
2. Qiitaアクセストークンを設定（60 → 1000リクエスト/時）

「指定された記事が見つかりませんでした」

原因: 記事IDが間違っているか、記事が非公開/削除

解決策:

• URLから記事IDを確認
• 記事が公開されているか確認

エラーハンドリング

サーバーは実用的な日本語エラーメッセージを提供：

• 429（レート制限）: Retry-Afterヘッダーから具体的な再試行時間を提示
• 404（見つからない）: 「記事が見つかりませんでした」という明確なメッセージ
• 401（認証エラー）: 無効なアクセストークンの通知
• ネットワークエラー: 接続失敗の詳細