Aleph-10: Vector Memory MCP Server

Aleph-10：ベクトルメモリー MCP サーバー

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

特長

• 気象情報：National Weather Service 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：メモリーストアの統計情報を取得します

  • パラメーター：なし

設定

以下の環境変数を設定できます。

変数	説明	デフォルト
EMBEDDING_PROVIDER	ベクトル埋め込みのプロバイダー（gemini または ollama）	gemini
GEMINI_API_KEY	Google Gemini の API キー	-
OLLAMA_BASE_URL	Ollama API のベース URL	http://localhost:11434
VECTOR_DB_PATH	ベクトルデータベースの保存場所	./data/vector_db
LOG_LEVEL	ログの詳細度	info

開発

プロジェクト構成

このプロジェクトはモジュール構成に従っています。

aleph-10/
├── src/                         # Source code
│   ├── index.ts                 # Main application entry point
│   ├── weather/                 # Weather service module
│   ├── memory/                  # Memory management module
│   ├── utils/                   # Shared utilities
│   └── types/                   # TypeScript type definitions
├── tests/                       # Test files
└── vitest.config.ts             # Vitest configuration

テストの実行

このプロジェクトでは、テストに Vitest を使用します。以下のコマンドでテストを実行します。

# Run tests once
pnpm test

# Run tests in watch mode during development
pnpm test:watch

# Run tests with UI (optional)
pnpm test:ui

ビルド

pnpm build

ライセンス

このプロジェクトは ISC ライセンスの下でライセンスされています。

謝辞

• Model Context Protocol
• National Weather Service API
• Vitest - 次世代のテストフレームワーク