Aleph 10

🚀 Project Code: Aleph-10 Vector Memory MCP Server

Aleph-10 is a Model Context Protocol (MCP) server that combines weather data services with vector storage. This project offers tools for retrieving weather information and managing semantic memories through vector embeddings.

✨ Features

• Weather Information: Fetch weather alerts and forecasts using the US National Weather Service API.
• Vector Memory: Store and retrieve information using semantic search.
• Multiple Embedding Options: Support both cloud-based (Google Gemini) and local (Ollama) embedding providers.
• Metadata Support: Add and filter metadata for efficient memory management.

🚀 Quick Start

Dependencies

• Node.js 18.x or higher
• pnpm package manager

📦 Installation

1. Clone the repository

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

2. Install dependencies

pnpm install

3. Configure environment variables (create a .env file in the project root directory)

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

4. Build the project

pnpm build

5. Run the server

node build/index.js

💻 Usage Examples

The server implements the Model Context Protocol and provides the following tools:

Weather Tools

• get-alerts: Retrieve weather alerts for a specific US state.

  • Parameter: state (two-letter state code)

• get-forecast: Get the weather forecast for a location.

  • Parameters: latitude and longitude

Memory Tools

• memory-store: Store information in the vector database.

  • Parameters: text (content), metadata (optional associated data)

• memory-retrieve: Retrieve semantically similar information.

  • Parameters: query (search text), limit (maximum number of results), filters (metadata filters)

• memory-update: Update an existing memory entry.

  • Parameters: id (memory ID), text (new content), metadata (updated metadata)

• memory-delete: Delete an entry from the database.

  • Parameter: id (ID of the memory to delete)

• memory-stats: Get statistics about the stored information.

  • No parameters

📚 Documentation

The following environment variables can be configured to control the server's behavior:

🔧 Technical Details

The project's directory structure is as follows:

aleph-10/
├── src/                # Source code
│   ├── server.js       # Main server file
│   └── vector-store.js # Vector storage implementation
├── package.json        # Package dependencies and scripts
└── .env                # Environment variable configuration

🧪 Testing

To run tests, use the following command:

pnpm test

To run tests in watch mode:

pnpm test:watch

📄 License

This project is licensed under the MIT License.

🙏 Acknowledgments

Thanks to the following projects and tools:

• Google Gemini - Provides powerful vector embedding capabilities.
• Ollama - Offers local vector storage support.
• Node.js and pnpm - Fundamental runtime and dependency management.

This project is developed by Your Name, aiming to provide a flexible and powerful memory management and weather information tool.