📰 tech-collector-mcp

Qiita × MCP × Gemini — AI クライアントから呼び出せる “技術記事収集・要約 & Notion 連携” プロトタイプ

---

✨ What’s this?

tech-collector-mcp は MCP (Model Context Protocol) を使い、複数ソース（Qiita／Dev.to／NewsAPI／Hacker News）から技術記事を一括取得し、Gemini API で要約、Notion データベースへ自動同期まで行う CLI ベースの実験プロジェクト です。

AI-Powered Prototyping: ChatGPT や Claude を活用した迅速なプロトタイピングを実施しています。

機能	説明
Zero‑Server	JSON‑RPC over STDIO — Web サーバー不要
Multi‑Source	Qiita／Dev.to／NewsAPI.org／Hacker News API を横断ラップ
Summarize	URL 要約 (summarizeUrlArticle) ＆ Qiita 特化要約
Aggregate	全ソース取得 (fetchAllArticles) ＆ 一括 Notion 同期 (aggregateArticles)
Recommend	読了 × 評価 × タグベースの簡易レコメンド (recommendArticles)
Easy Integration	Claude Desktop などで関数呼び出し感覚で利用可能

Prototyping Phase 🛠️  スキーマ & プロンプトは随時更新中。

---

🔧 Requirements

• Node.js 18.x 以上
• npm または yarn
• .env は .env.example を参照して作成

# ==== API Keys & Tokens ====
GEMINI_API_KEY=your_gemini_api_key_here     # Google Generative AI
NEWSAPI_KEY=your_newsapi_api_key_here       # NewsAPI.org
QIITA_TOKEN=your_qiita_token_here           # Qiita (optional)

# ==== Pagination Settings ====
PAGE_LIMIT=3        # デフォルト取得件数/サービス
ITEMS_PER_PAGE=10   # ページネーション単位

# ==== Notion Integration ====
NOTION_API_KEY=your_notion_api_key_here     # Notion Integration Token
NOTION_DATABASE_ID=your_database_id_here    # 記事保存用DB ID

Dev.to／Hacker News は API キー不要です。

---

📦 Installation / Quick Start

# 1) Clone
$ git clone https://github.com/RuumaLilja/tech-collector-mcp.git
$ cd tech-collector-mcp

# 2) Install dependencies
$ npm install   # または yarn install

# 3) Setup environment
$ cp .env.example .env
# .env を編集して各種キーを入力

# 4) Run MCP server (STDIO mode)
$ node src/index.js

🛠️ Using with Claude Desktop

settings.json に MCP サーバーを登録：

{
  "mcpServers": {
    "tech-collector": {
      "command": "node",
      "args": ["/absolute/path/to/tech-collector-mcp/src/index.js"]
    }
  }
}

起動後、チャット例：

Dev.toでreactタグの記事を3件取得して
最新テックニュースを取得して
Hacker Newsのトップ技術ネタを5件
https://example.com/article を要約して
取得した記事を Notion に保存して
全ソースを取得して Notion に同期して
全部まとめて最新技術記事を取得して
おすすめ記事（パーソナライズ推薦）を5件教えて```

---

📂 Project Structure

tech-collector-mcp/
├── adapters/
│   └── notionSdkStorage.js       # Notion SDK 実装 (StoragePort)
├── clients/
│   ├── devtoClient.js
│   ├── geminiClient.js
│   ├── hackerNewsClient.js
│   ├── newsApiClient.js
│   └── qiitaClient.js
├── config/
│   ├── constants.js
│   ├── environment.js
│   ├── prompts.js                # プロンプト定義
│   ├── toolDefinitions.dynamic.js# Notionスキーマ連動ツール
│   └── toolDefinitions.static.js # 静的ツール定義
├── ports/
│   └── storage.js                # StoragePort インターフェース
├── services/
│   ├── aggregatorService.js      # 全ソース取得→Notion同期
│   ├── devtoService.js
│   ├── fetchService.js           # 全ソース取得
│   ├── hackerNewsService.js
│   ├── newsApiService.js
│   ├── qiitaRanking.js
│   ├── recommenderService.js     # 読了×評価×タグベース推薦
│   ├── reportService.js          # 同期結果レポート
│   ├── summarizeService.js       # URL要約
│   ├── syncBatchService.js       # Notion並列同期
│   └── syncService.js            # 単一記事同期
├── utils/
│   ├── errors.js
│   ├── fieldMapper.js            # 外部→Notionフィールド変換
│   ├── rpcHelpers.js
│   └── simhash.js                # URL→SimHash (MD5)
└── index.js                      # エントリーポイント

---

📖 JSON‑RPC Overview

Method	説明	Params	Returns
initialize	MCP ハンドシェイク	—	capabilities.tools
tools/list	利用可能ツール一覧	—	name, description, inputSchema
tools/call	ツール実行	name, arguments	実行結果 (content[])

Main Tools (抜粋)

• getQiitaRanking — Qiita 人気記事ランキング取得
• getDevtoArticles — Dev.to のタグ/検索記事取得
• getNewsApiArticles — NewsAPI.org からテックニュース取得
• getHackerNewsTopStories — Hacker News トップストーリー取得
• fetchAllArticles — 全ソースまとめて最新取得
• summarizeUrlArticle — 任意 URL 記事を Gemini で要約
• syncArticleToNotion — 記事を Notion に保存
• aggregateArticles — 全ソース取得 →Notion 一括同期
• recommendArticles — 読了 × 評価 × タグで簡易推薦

詳細は toolDefinitions.*.js を参照。

---

🩹 Troubleshooting

エラー／症状	解決策
Unsupported content type: json	MCP クライアントが type:'text' 以外のレスポンスを受信。ツール実装を確認
401 Unauthorized	.env の NEWSAPI_KEY または NOTION_API_KEY を確認
ツールが呼ばれない	descriptionForModel／inputSchema を見直し、クライアント再起動

---

🗺 Roadmap

1. Phase 1: Qiita ランキング＋要約 (✅)
2. Phase 2: マルチソース収集 (✅)
3. Phase 3: Notion 連携 & パーソナライズ推薦 (✅)
4. Phase 4: Slack 連携
5. Phase 5: 定期バッチ