Aleph-10: Vector Memory MCP Server

基本能力

产品定位

Aleph-10 是一个结合了天气数据服务和基于向量的内存存储的 MCP 服务器，旨在提供天气信息检索和语义记忆管理功能。

核心功能

• 天气信息：通过国家气象服务 API 获取天气警报和预报。
• 向量内存：使用语义搜索存储和检索信息。
• 多种嵌入选项：支持基于云的（Google Gemini）和本地的（Ollama）嵌入提供程序。
• 元数据支持：添加和通过元数据过滤以高效管理内存。

适用场景

• 需要实时天气信息的应用。
• 需要语义记忆存储和检索的应用。
• 需要结合天气数据和语义记忆的应用。

工具列表

天气工具

• 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。
• 如何设置 Google Gemini API 密钥？ 在 .env 文件中设置 GEMINI_API_KEY。
• 如何更改向量数据库的存储位置？ 在 .env 文件中设置 VECTOR_DB_PATH。

使用教程

使用依赖

• Node.js 18.x 或更高版本。
• pnpm 包管理器。

安装教程

1. 克隆仓库

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

1. 安装依赖

pnpm install

1. 配置环境变量（在项目根目录创建 .env 文件）

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

1. 构建项目

pnpm build

1. 运行服务器

node build/index.js

调试方式

• 运行测试

pnpm test

• 在开发过程中以监视模式运行测试

pnpm test:watch

• 运行带有 UI 的测试（可选）

pnpm test:ui

许可证

该项目遵循 ISC 开源许可条款。