Aleph 10

🚀 プロジェクトコードネーム：Aleph - 10 ベクトルメモリ MCP サーバー

Aleph - 10 は、天気データサービスとベクトルストレージを組み合わせた Model Context Protocol (MCP) サーバーです。このプロジェクトでは、天気情報を取得し、ベクトル埋め込みを通じてセマンティックメモリを管理するためのツールを提供しています。

✨ 主な機能

• 天気情報：米国国家気象局 API を使用して、天気警報と予報を取得します。
• ベクトルメモリ：セマンティック検索を使用して、情報を保存および検索します。
• 複数の埋め込みオプション：クラウドベース（Google Gemini）とローカル（Ollama）の埋め込みプロバイダーをサポートしています。
• メタデータサポート：メタデータを追加およびフィルタリングして、効率的なメモリ管理を実現します。

🚀 クイックスタート

📦 インストール

依存関係

• Node.js 18.x 以上
• pnpm パッケージマネージャー

手順

1. リポジトリをクローンします。

git clone https://github.com/yourusername/aleph-10.git
cd aleph-10

2. 依存関係をインストールします。

pnpm install

3. 環境変数を設定します（プロジェクトのルートディレクトリに .env ファイルを作成）。

EMBEDDING_PROVIDER=gemini
GEMINI_API_KEY=your_gemini_api_key
VECTOR_DB_PATH=./data/vector_db
LOG_LEVEL=info

4. プロジェクトをビルドします。

pnpm build

5. サーバーを起動します。

node build/index.js

💻 使用例

このサーバーは Model Context Protocol を実装し、以下のツールを提供します。

天気ツール

• get - alerts：特定の米国の州の天気警報を取得します。

  • パラメータ：state（2 文字の州コード）

• get - forecast：位置の天気予報を取得します。

  • パラメータ：latitude と longitude

メモリツール

• memory - store：情報をベクトルデータベースに保存します。

  • パラメータ：text（内容）、metadata（オプションの関連データ）

• memory - retrieve：セマンティックに類似した情報を検索します。

  • パラメータ：query（検索テキスト）、limit（最大結果数）、filters（メタデータフィルター）

• memory - update：既存のメモリエントリを更新します。

  • パラメータ：id（メモリ ID）、text（新しい内容）、metadata（更新されたメタデータ）

• memory - delete：データベースからエントリを削除します。

  • パラメータ：id（削除するメモリ ID）

• memory - stats：保存された情報の統計を取得します。

  • パラメータ：なし

📚 ドキュメント

設定オプション

以下の環境変数を使用して、サーバーの動作を設定できます。

プロジェクト構造

以下はプロジェクトのディレクトリ構造です。

aleph-10/
├── src/                # ソースコード
│   ├── server.js       # メインサーバーファイル
│   └── vector-store.js # ベクトルストレージの実装
├── package.json        # パッケージ依存関係とスクリプト
└── .env                # 環境変数の設定

テスト

テストを実行するには、以下のコマンドを使用します。

pnpm test

監視モードでテストを実行するには、以下のコマンドを使用します。

pnpm test:watch

📄 ライセンス

このプロジェクトは MIT License の下で提供されています。

謝辞

以下のプロジェクトとツールに感謝します。

• Google Gemini - 強力なベクトル埋め込み機能を提供します。
• Ollama - ローカルのベクトルストレージサポートを提供します。
• Node.js と pnpm - 基本的なランタイムと依存関係管理を提供します。

このプロジェクトは Your Name によって開発され、柔軟で強力なメモリ管理と天気情報ツールを提供することを目的としています。