Mnemosyne MCP 8aae233f

MCP数据服务

提供方 zhadyz · 包名 @zhadyz/mnemosyne-mcp

数据服务 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude
查看接入方式

Mnemosyne MCP 是一个为AI代理提供持久记忆的知识图谱服务,支持本地语义搜索和零API成本。

一句话选型结论

按资料字段整理

Mnemosyne MCP 8aae233f 属于数据服务类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 3 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量3暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

知识图谱TypeScript本地部署语义搜索AI代理本地处理Neo4j

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
npx @zhadyz/mnemosyne-mcp

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 3 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 3 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Mnemosyne MCP 8aae233f当前 3 stdio · 本地进程 本地部署 有 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方zhadyz上游标注的维护方 zhadyz
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@zhadyz/mnemosyne-mcp · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.1 KB
来自项目仓库与上游目录的原文,未做删改

Mnemosyne MCP

Knowledge graph memory for AI agents with local semantic search. Zero API costs.

> Named after Mnemosyne, the Greek goddess of memory and mother of the Muses.

Overview

Mnemosyne provides persistent memory for AI agents using Neo4j knowledge graphs and local vector embeddings. Unlike traditional solutions requiring paid API access, Mnemosyne runs embeddings locally via ONNX Runtime.

Key Features:
- Local semantic search with BGE embeddings
- No API keys or external dependencies
- Works offline after initial setup
- Compatible with Model Context Protocol (MCP)
- Drop-in replacement for cloud-based solutions

Performance Comparison

Metric Cloud Services Mnemosyne
Cost ~$0.02/1M tokens Free
API Key Required None
Network Always required Initial download only
Privacy External Local
Latency ~100ms ~200-500ms

Installation

Prerequisites

  • Node.js >= 20.0.0
  • Neo4j Database (Download)

Quick Start (NPM)```bash

npx @zhadyz/mnemosyne-mcp


### From Source```bash
git clone https://github.com/zhadyz/mnemosyne-mcp.git
cd mnemosyne-mcp
npm install
npm run build

Neo4j Setup

  1. Install Neo4j Desktop
  2. Create a database instance
  3. Set credentials (default password: neo4j)
  4. Start the database (default port: 7687)

Environment Configuration

Create .env in project root:```bash
EMBEDDING_PROVIDER=local
LOCAL_EMBEDDING_MODEL=Xenova/bge-base-en-v1.5

NEO4J_URI=bolt://127.0.0.1:7687
NEO4J_USERNAME=neo4j
NEO4J_PASSWORD=neo4j

NEO4J_DATABASE - Automatically set by router based on project config


## Multi-Project Database Routing

Mnemosyne includes **built-in dynamic database routing** that automatically selects the correct Neo4j database based on your current project.

### Why Use Multi-Database Architecture?

**Performance at Scale:**
- Query 10⁴ entities instead of 10⁵+ in monolithic architecture
- O(log n) query complexity through database partitioning
- Linear project addition without performance degradation

**Project Isolation:**
- Namespace separation prevents cross-contamination of knowledge graphs
- Each project gets its own isolated database
- Global patterns database for cross-project learnings

### Setup

**1. Create project databases in Neo4j:**```cypher
CREATE DATABASE my_project_db IF NOT EXISTS;
CREATE DATABASE another_project_db IF NOT EXISTS;

2. Add .mnemosyne file to each project root:```bash

Project-specific database name (required)

MNEMOSYNE_DATABASE=my_project_db

Optional metadata

PROJECT_NAME=My Project
RETENTION_DAYS=90
AUTO_CLEANUP=true
ISOLATION_LEVEL=project


**3. Router automatically detects database:**```
Your Projects:
├─ project-alpha/
│  └─ .mnemosyne          → MNEMOSYNE_DATABASE=alpha_db
│     Routes to "alpha_db" database ✓
│
├─ project-beta/
│  └─ .mnemosyne          → MNEMOSYNE_DATABASE=beta_db
│     Routes to "beta_db" database ✓
│
└─ unconfigured-project/
   No .mnemosyne → Routes to "neo4j" (global patterns) ✓

The router walks up the directory tree from your current working directory, finds .mnemosyne or .env, and routes to the specified database. If no config is found, it defaults to neo4j (global patterns database).

Template:
Copy the included template to your project:```bash
cp node_modules/@zhadyz/mnemosyne-mcp/.mnemosyne.template .mnemosyne

Edit MNEMOSYNE_DATABASE to your database name


## Claude Integration

### Claude Code (Recommended)

Add Mnemosyne to Claude Code with a single command:```bash
claude mcp add --scope user mnemosyne -- npx -y @zhadyz/mnemosyne-mcp

Verify it's installed:```bash
claude mcp list


You should see `mnemosyne: npx -y @zhadyz/mnemosyne-mcp - ✓ Connected`

**Default Configuration:**
- Neo4j URI: `bolt://localhost:7687`
- Username/Password: `neo4j` / `neo4j`
- Database: Automatic (via router - `neo4j` if no `.mnemosyne` file found)
- Embeddings: Local (BGE base-en-v1.5, 768 dimensions)

**Custom Neo4j Setup:**
If you use different credentials, edit `~/.claude.json` and add environment variables:```bash
claude mcp add --scope user mnemosyne \
  -e NEO4J_PASSWORD=your_password \
  -- npx -y @zhadyz/mnemosyne-mcp

Dual MCP Instance Setup (Project + Global Memory)

For advanced workflows, run two separate Mnemosyne instances - one for project-specific knowledge and one for cross-project patterns.

Architecture:
- Project Instance: Uses automatic routing (finds .mnemosyne in your project)
- Global Instance: Always routes to neo4j database (forced override)

Setup:```bash

Project-specific knowledge (automatic routing)

claude mcp add --scope user mnemosyne-project -- npx -y @zhadyz/mnemosyne-mcp

Global cross-project patterns (forced to neo4j database)

claude mcp add --scope user mnemosyne-global \
-e MNEMOSYNE_FORCE_DATABASE=neo4j \
-- npx -y @zhadyz/mnemosyne-mcp


**Agent Usage:**

Tools appear with prefixes in Claude:
- `mcp__mnemosyne-project__create_entities` → stores in project database
- `mcp__mnemosyne-global__create_entities` → stores in global `neo4j` database

**Decision Heuristic for Agents:**

Store in **project database** when knowledge is:
- Project-specific code: classes, functions, APIs, models
- Project context: dependencies, architecture decisions, local conventions
- Temporary learnings: current sprint patterns, debugging insights

Store in **global database** when knowledge is:
- Reusable patterns: error handling strategies, design patterns
- Framework best practices: Next.js optimization, React patterns
- Security patterns: authentication flows, input validation
- Meta-learnings: what works across multiple projects

**Default Rule**: When uncertain, store in project database. Manually promote proven patterns to global database after validation.

### Claude Desktop

**Basic Setup:**

Add to `claude_desktop_config.json`:```json
{
  "mcpServers": {
    "mnemosyne": {
      "command": "npx",
      "args": ["-y", "@zhadyz/mnemosyne-mcp"],
      "env": {
        "NEO4J_URI": "bolt://127.0.0.1:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "neo4j",
        "EMBEDDING_PROVIDER": "local",
        "LOCAL_EMBEDDING_MODEL": "Xenova/bge-base-en-v1.5"
      }
    }
  }
}

Dual Instance Setup (Project + Global):```json
{
"mcpServers": {
"mnemosyne-project": {
"command": "npx",
"args": ["-y", "@zhadyz/mnemosyne-mcp"],
"env": {
"NEO4J_URI": "bolt://127.0.0.1:7687",
"NEO4J_USERNAME": "neo4j",
"NEO4J_PASSWORD": "neo4j",
"EMBEDDING_PROVIDER": "local",
"LOCAL_EMBEDDING_MODEL": "Xenova/bge-base-en-v1.5"
}
},
"mnemosyne-global": {
"command": "npx",
"args": ["-y", "@zhadyz/mnemosyne-mcp"],
"env": {
"NEO4J_URI": "bolt://127.0.0.1:7687",
"NEO4J_USERNAME": "neo4j",
"NEO4J_PASSWORD": "neo4j",
"EMBEDDING_PROVIDER": "local",
"LOCAL_EMBEDDING_MODEL": "Xenova/bge-base-en-v1.5",
"MNEMOSYNE_FORCE_DATABASE": "neo4j"
}
}
}
}


### Local Development```json
{
  "mcpServers": {
    "mnemosyne": {
      "command": "node",
      "args": ["/absolute/path/to/mnemosyne-mcp/dist/router.js"],
      "env": {
        "NEO4J_URI": "bolt://127.0.0.1:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "neo4j",
        "EMBEDDING_PROVIDER": "local",
        "LOCAL_EMBEDDING_MODEL": "Xenova/bge-base-en-v1.5"
      }
    }
  }
}

Embedding Models

Mnemosyne supports multiple BGE models:

Model Dimensions Size Use Case
bge-base-en-v1.5 768 90MB Balanced (default)
bge-small-en-v1.5 384 30MB Resource-constrained
bge-large-en-v1.5 1024 200MB Maximum accuracy
bge-m3 1024 200MB Multilingual

Models download automatically on first use and cache to ~/.cache/huggingface/.

Usage

Create Entities```javascript

{
"name": "create_entities",
"arguments": {
"entities": [{
"name": "TypeScript",
"entityType": "programming_language",
"observations": [
"Strongly typed superset of JavaScript",
"Compiles to JavaScript",
"Static type checking"
]
}]
}
}


### Semantic Search```javascript
{
  "name": "semantic_search",
  "arguments": {
    "query": "type-safe languages for web development",
    "limit": 5
  }
}

Create Relations```javascript

{
"name": "create_relations",
"arguments": {
"relations": [{
"from": "TypeScript",
"to": "JavaScript",
"relationType": "compiles_to"
}]
}
}


## Architecture```
EmbeddingServiceFactory
├── DefaultEmbeddingService (testing)
├── OpenAIEmbeddingService (cloud)
└── LocalEmbeddingService (ONNX)

All services implement IEmbeddingService, enabling seamless provider swapping.

Local Embeddings Stack

  • ONNX Runtime: Optimized ML inference
  • Transformers.js: JavaScript ML library
  • BGE Models: BAAI general embeddings
  • L2 Normalization: Vector similarity search

Development```bash

npm test # Run tests
npm run test:watch # Watch mode
npm run build # Build
npm run dev # Development mode
npm run fix # Lint and format
```

Configuration

Variable Options Description
EMBEDDING_PROVIDER auto, local, openai Provider selection
LOCAL_EMBEDDING_MODEL BGE model name Local model choice
NEO4J_URI bolt://... Database connection
NEO4J_USERNAME string Database user
NEO4J_PASSWORD string Database password
NEO4J_DATABASE string Database name

Provider Selection:
- auto: OpenAI if API key present, otherwise local
- local: Always use local embeddings
- openai: Always use OpenAI (requires API key)

Credits

Forked from memento-mcp by Gannon Hall.

Additions:
- Local ONNX embedding support
- BGE model integration
- Auto-fallback configuration
- Zero-dependency operation

License

MIT License - see LICENSE file.

Contributing

Pull requests welcome.


Built by zhadyz
Powered by ONNX Runtime + Transformers.js + BGE Embeddings

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Mnemosyne MCP 8aae233f 怎么安装?

在客户端按下面的安装命令接入:npx @zhadyz/mnemosyne-mcp。对应的包名是 @zhadyz/mnemosyne-mcp。装完在客户端配置里引用同一个包或端点。

Mnemosyne MCP 8aae233f 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Mnemosyne MCP 8aae233f 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Mnemosyne MCP 8aae233f 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Mnemosyne MCP 8aae233f 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Mnemosyne MCP 8aae233f 能提供哪些能力?

资料显示约 3 个工具;能力标签包括 知识图谱、本地处理、TypeScript、Claude、搜索。具体工具清单以官方文档为准。

Mnemosyne MCP 8aae233f 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Mnemosyne MCP 8aae233f 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。