Memex (Firecrawl & Voyage)

🚀 Memex Model Context Protocol Tool

Memex is a tool based on the Model Context Protocol (MCP) that analyzes web page content and adds it to your knowledge base.

This tool is inspired by the Memex project, proposed by Vannevar Bush.

🚀 Quick Start

Prerequisites

You need API keys for the following services:

• Claude API
• FireCrawl API
• Voyage API

The knowledge base generated by the Memex tool is stored as Markdown files, which can be viewed using any Markdown viewer. However, Obsidian is recommended.

📦 Installation

pip install mcp-memex

Add the following content to your claude_desktop_config.json and replace the placeholders with the actual paths and API keys:

{
  "mcpServers": {
    "memex": {
      "command": "uv",
      "args": [
        "--directory",
        "PATH_TO_LOCAL_MEMEX_REPO",
        "run",
        "mcp-memex",
        "--index",
        "PATH_TO_MEMEX_INDEX",
        "--workspace",
        "PATH_TO_OBSIDIAN_VAULT"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR-API-KEY",
        "FIRECRAWL_API_KEY": "YOUR-API-KEY",
        "VOYAGE_API_KEY": "YOUR-API-KEY"
      }
    }
  }
}

💻 Usage Examples

Basic Usage

First, ask Claude a question by providing a list of URLs to reference.

What is the capital of France? "https://en.wikipedia.org/wiki/France"

After Claude analyzes the content, you'll see the results in your Obsidian folder. Then you can ask questions about the content, and Memex will use the knowledge base to answer your questions.

What is the capital of France?

🔧 Technical Details

Local Development

To run the tool locally, use the following command:

npx @modelcontextprotocol/inspector \
  uv \
  --directory PATH_TO_LOCAL_MEMEX_REPO \
  run \
  mcp-memex \
  --index PATH_TO_MEMEX_INDEX \
  --workspace PATH_TO_OBSIDIAN_VAULT

Then open the inspector and connect to the server. http://localhost:5173?timeout=30000