Aleph-10: Vector Memory MCP Server

Aleph-10：向量记忆 MCP 服务

Aleph-10 是一个模型上下文协议（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

用法

该服务实现了模型上下文协议，并提供以下工具：

天气工具

• 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：获取记忆存储的统计信息

  • 参数：无

配置

可以配置以下环境变量：

变量	描述	默认值
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 许可证。

致谢

• 模型上下文协议
• 美国国家气象局 API
• Vitest - 新一代测试框架