Kivv

🚀 arXiv自動論文探索とAI要約システム

このシステムは、Claude DesktopにMCP（Model Context Protocol）を統合した、arXivの研究論文を自動的に探索し、AIによる要約を行うシステムです。vibe-codingプロジェクトとして構築され、軽量なツールと高速なフィードバックループを実現し、研究の洞察を提供しながらも作業の流れを阻害しないようにしています。

✨ 主な機能

• 毎日の自動化：指定したトピックに合致する論文をarXivから自動的に検索します。
• AI要約：Claudeを用いた論文のインテリジェントな要約機能で、コストを最適化しています。
• マルチユーザー対応：複数のユーザーが独立したトピック設定で利用できます。
• MCP統合：Model Context Protocolを介してClaude Desktopと直接統合されています。
• RSSフィード：各ユーザー用のRSS/Atomフィードを提供し、任意のフィードリーダーで利用できます。
• Webダッシュボード：オプションのSvelteKitダッシュボード（近日公開予定）
• コスト効率：主にCloudflareの無料枠で動作し（2ユーザーで月約$3）、低コストで利用できます。

🔧 技術詳細

アーキテクチャ

• MCPサーバー：MCPプロトコルとツールの実行を処理するTypeScript Workerです。
• 毎日の自動化：論文の収集と要約を行うCronトリガーのWorkerです。
• ストレージ：Cloudflare D1（SQLite）、R2（PDF）、KV（キャッシュ）を使用しています。
• AI：コスト最適化のためにHaikuトリアージを備えたClaude 3.5 Sonnetを使用しています。

🚀 クイックスタート

前提条件

• Workers、D1、KV、R2が有効なCloudflareアカウント
• Anthropic Claude APIキー（console.anthropic.com）
• Bun 1.1+（パッケージマネージャー - bun.shからインストール）
• Wrangler CLI（bunを通じて自動的にインストールされます）

📦 インストール

# リポジトリをクローン
git clone https://github.com/jeffaf/kivv.git
cd kivv

# bunで依存関係をインストール（vibe-codingのデフォルト）
bun install

# 環境変数を設定
cp .env.example .env
# .envを編集してAPIキーとCloudflareの資格情報を入力

デプロイ

完全なデプロイ手順については、DEPLOYMENT.md を参照してください。

クイックデプロイ：

# 自動化ワーカーのシークレットを設定
cd automation
wrangler secret put CLAUDE_API_KEY
wrangler secret put CRON_SECRET

# 自動化ワーカーをデプロイ
wrangler deploy

# MCPサーバーをデプロイ
cd ../mcp-server
wrangler deploy

# Claude Desktopを設定（詳細はDEPLOYMENT.mdを参照）
# Claude Desktopの設定にMCPサーバーのURLとAPIキーを追加

検証

# 自動化ワーカーをテスト
curl https://kivv-automation.<username>.workers.dev/health

# MCPサーバーをテスト
curl https://kivv-mcp.<username>.workers.dev/health

# データベースを確認
wrangler d1 execute kivv-db --command "SELECT COUNT(*) FROM users"

# または自動化されたヘルスチェックスクリプトを使用
./scripts/health-check.sh

問題が発生した場合は、TROUBLESHOOTING.md を参照してください。

自動化されたデプロイスクリプト

1コマンドでのデプロイ：

# 自動化されたデプロイスクリプトを実行
./scripts/deploy.sh

# これにより以下のことが行われます：
# - 前提条件を検証
# - インフラストラクチャをチェック
# - シークレットを設定
# - 両方のワーカーをデプロイ
# - Claude Desktopの設定を提供

📚 ドキュメント

• デプロイガイド - 本番環境での完全なデプロイ手順
• トラブルシューティングガイド - 一般的な問題と解決策
• セットアップチェックリスト - インフラストラクチャのセットアップ
• 実装計画 - チャンク化された開発ガイド
• APIドキュメント - APIエンドポイントと使用方法
• PRD（完全仕様） - 完全な技術仕様

CIと自動化

• テストと型チェック：GitHub Actionsがプッシュとプルリクエスト時に bun run type-check と bun test を実行し、ビルドを壊さずに高速なvibe codingを維持します。
• デプロイ：mcp-server/ または automation/ が変更されたときに、Cloudflare Workersのデプロイパイプラインがトリガーされ、設定されたCloudflareの資格情報を使用して wrangler を実行します。

💻 使用例

開発

# 型チェックを実行
bun run type-check

# すべてのテストを実行
bun test

# セキュリティテストを実行
bun run test:security

# ウォッチモードでテストを実行
bun run test:watch

# MCPサーバーをローカルで実行
bun run dev:mcp

# 自動化ワーカーをローカルで実行
bun run dev:automation

# すべてのワークスペースをビルド
bun run build

テスト

このプロジェクトには包括的なテストが含まれています：

• セキュリティテスト（100%のカバレッジが必要）：
  • 認証（APIキーの検証）
  • 承認（ユーザーデータの分離）
  • SQLインジェクション防止
  • RSSフィードのXSS防止
  • レート制限の適用
• 統合テスト：エンドツーエンドのMCPツールワークフロー
• 単体テスト：独立したユーティリティ関数のテスト

# カバレッジレポート付きでテストを実行
bun run test:coverage

プロジェクト構造

kivv/
├── mcp-server/          # MCPサーバーワーカー（Claude統合）
├── automation/          # 毎日の自動化ワーカー（cron）
├── shared/              # 共有型とユーティリティ
├── tests/
│   ├── security/       # セキュリティテスト（認証、インジェクション、XSS）
│   ├── integration/    # MCPツールの統合テスト
│   └── unit/           # 単体テスト
├── .checkpoint/         # 開発チェックポイント
└── package.json         # ワークスペースを持つモノレポのルート

📄 ライセンス

MIT