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/                         # 源代码
│   ├── index.ts                 # 主应用程序入口点
│   ├── weather/                 # 天气服务模块
│   ├── memory/                  # 内存管理模块
│   ├── utils/                   # 共享实用程序
│   └── types/                   # TypeScript 类型定义
├── tests/                       # 测试文件
└── vitest.config.ts             # Vitest 配置

运行测试

该项目使用 Vitest 进行测试。使用以下命令运行测试：

# 运行测试一次
pnpm test

# 在开发期间以监视模式运行测试
pnpm test:watch

# 使用 UI 运行测试（可选）
pnpm test:ui

构建

pnpm build

许可证

该项目根据 ISC 许可证获得许可。

致谢

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