# 📰 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**: 定期バッチ
