Aleph 10

🚀 項目代號：Aleph - 10 向量內存 MCP 服務器

Aleph - 10 是一款融合天氣數據服務與向量存儲功能的 Model Context Protocol (MCP) 服務器。它提供了一系列工具，可用於獲取天氣信息，並通過向量嵌入技術對語義記憶進行管理。

🚀 快速開始

Aleph - 10 結合了天氣數據服務與向量存儲功能，能幫助你輕鬆獲取天氣信息並管理語義記憶。以下是快速上手的步驟：

依賴項

• 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

✨ 主要特性

• 天氣信息：藉助美國國家氣象局 API，獲取天氣警報和預報。
• 向量內存：運用語義搜索功能，實現信息的存儲和檢索。
• 多種嵌入選項：支持基於雲的（Google Gemini）和本地（Ollama）嵌入提供程序。
• 元數據支持：可添加和過濾元數據，實現高效的記憶管理。

💻 使用示例

基礎用法

該服務器實現了 Model Context Protocol 並提供以下工具：

天氣工具

• get - alerts：獲取特定美國州的天氣警報

  • 參數：state（兩位字母州代碼）

• 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 開發，旨在提供一個靈活且強大的記憶管理和天氣信息工具。