Which integrations are available for this server?

Retrieves articles from Dev.to based on tags and search queries, enabling access to community-driven technical content. Uses Gemini API to summarize articles from URLs and generate summaries of technical content from various sources. Synchronizes and saves technical articles to Notion databases, with support for batch operations, field mapping, and article deduplication using SimHash. Fetches popular articles and rankings from Qiita, a Japanese technical knowledge sharing platform, with support for article summarization using Gemini AI.

How do I use tech-collector-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@tech-collector-mcp fetch all recent tech articles and sync them to my Notion database" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

📰 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

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

tech-collector-mcp