star-knowledge-base は何をしますか？
あなたのGitHub Starsを単なるブックマークから、エージェントが検索可能なパーソナルコードツールボックスへ変換します。MCP + Agent Skill + GitHub Pagesを統合。
概要
このプロジェクトは、あなたがGitHubでスターを付けたリポジトリを、AIエージェント（Claude Code、Cursor、Codexなど）が直接検索・参照できる知識ベースとして機能させるためのツールキットです。
従来、GitHub Starsは単なるブックマークとしてしか機能しませんでしたが、このツールを使用することで、エージェントはあなたが興味を持ったライブラリやツール、コードスニペットをコンテキストに応じて動的に検索し、開発ワークフローに組み込むことができます。
主な機能
- スターリストの自動収集: GitHub Actionsを利用して定期的にあなたのスターを取得
- ベクトル検索対応: スターしたリポジトリのREADMEやコードをベクトル化し、エージェントが自然言語で検索可能に
- MCPサーバー統合: Model Context Protocol (MCP) サーバーとして動作し、Claude Codeなどの対応エージェントから直接アクセス可能
- Agent Skill定義: CursorやCodexなどのエージェント向けのSkill定義ファイルを提供
- GitHub Pagesフロントエンド: ブラウザからもスターリストを閲覧可能なWebインターフェース
クイックスタート
- このリポジトリをテンプレートとしてフォーク
- GitHub Secretsに
GH_TOKEN（パーソナルアクセストークン）を設定 - GitHub Actionsのワークフローを有効化
- エージェント（Claude Code、Cursorなど）にSkill/MCPサーバーを登録
対応エージェント
- Claude Code: MCPサーバーとして直接利用可能
- Cursor: .cursorrules または Skill定義ファイルを通じて利用
- Codex: Skill定義ファイルを通じて利用
- その他MCP対応エージェント: 標準MCPサーバーとして利用可能
アーキテクチャ
GitHub Stars
↓
GitHub Actions（定期実行）
↓
ベクトルDB（ローカルまたはクラウド）
↓
MCPサーバー / Agent Skill定義
↓
AIエージェント
設定
MCPサーバー設定
{
"mcpServers": {
"star-knowledge-base": {
"command": "npx",
"args": ["-y", "@fxbin/star-knowledge-base"],
"env": {
"GH_TOKEN": "${YOUR_GITHUB_TOKEN}"
}
}
}
}
環境変数
| 変数名 | 必須 | 説明 |
|---|---|---|
GH_TOKEN | はい | GitHub パーソナルアクセストークン（スター情報取得用） |
STAR_USER | いいえ | スターを取得するユーザー名（デフォルト: 自分自身） |
UPDATE_INTERVAL | いいえ | 更新間隔（cron形式、デフォルト: 毎日0時） |
開発
ローカルで開発する場合:
# リポジトリをクローン
git clone https://github.com/fxbin/star-knowledge-base.git
cd star-knowledge-base
# 依存関係をインストール
npm install
# 開発サーバーを起動
npm run dev
このプロジェクトは MITライセンス の下で公開されています。