项目代号：Aleph-10 向量内存 MCP 服务器

Aleph-10 是一个结合天气数据服务与向量存储的 Model Context Protocol (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

使用说明

该服务器实现 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 开发，旨在提供一个灵活且强大的记忆管理和天气信息工具。