# Eion — Shared Memory Server + MCP for Agents

> A shared-memory server for multi-agent systems with Postgres+Neo4j and embedded MCP tools; verified 155★, pushed 2025-07-02.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

```bash
git clone https://github.com/eiondb/eion.git
cd eion
docker-compose up -d
docker exec eion_postgres psql -U eion -d eion -c "CREATE EXTENSION IF NOT EXISTS vector;"
go build -o eion-server ./cmd/eion-server
./eion-server
curl http://localhost:8080/health
```

## Intro

A shared-memory server for multi-agent systems with Postgres+Neo4j and embedded MCP tools; verified 155★, pushed 2025-07-02.

**Best for:** Builders who want a self-hosted shared memory layer (plus MCP tools) for agent sessions

**Works with:** Docker Compose, Go 1.21+, Python 3.13+ (README prerequisites); exposes HTTP server on :8080

**Setup time:** 25-50 minutes

### Key facts (verified)

- GitHub: 155 stars · 11 forks · pushed 2025-07-02.
- License: AGPL-3.0 · owner avatar + repo URL verified via GitHub API.
- README-backed entrypoint: `./eion-server`.

## Main

- Bring up storage first: README expects PostgreSQL + Neo4j via `docker-compose up -d`, plus pgvector enabled.

- Verify health early: hit `/health` after `./eion-server` so you debug infrastructure before wiring MCP clients.

- Use MCP for agent-facing memory ops: README shows connecting via `python -m internal.mcp.server` with `EION_BASE_URL`.

- Treat auth fields as mandatory: README says MCP tools require `session_id`, `agent_id`, and `user_id`—register agents before tool calls.

### Source-backed notes

- README lists prerequisites: Docker Compose, Go 1.21+, and Python 3.13+.
- README quickstart uses HTTP on `http://localhost:8080` with a `/health` endpoint and a web console at `/console/` (trailing slash required).
- README documents MCP configuration in `eion.yaml` including a default MCP port (8081) and that MCP is embedded in the server process.

### FAQ

- **Do I need to run a separate MCP daemon?**: README says the MCP server is embedded in the Eion server process; clients connect via provided tooling.
- **Why does the console URL require a trailing slash?**: README explicitly warns to include `/` for `http://localhost:8080/console/`.
- **How do I authenticate MCP tool calls?**: README requires `session_id`, `agent_id`, and `user_id`, and agents must be registered first.

## Source & Thanks

> Source: https://github.com/eiondb/eion
> License: AGPL-3.0
> GitHub stars: 155 · forks: 11

---

<!-- ZH -->

## Quick Use

```bash
git clone https://github.com/eiondb/eion.git
cd eion
docker-compose up -d
docker exec eion_postgres psql -U eion -d eion -c "CREATE EXTENSION IF NOT EXISTS vector;"
go build -o eion-server ./cmd/eion-server
./eion-server
curl http://localhost:8080/health
```

## Intro

Eion 是多 agent 共享记忆服务器：Postgres+Neo4j 存储，并内置 MCP 工具接口，适合在对话会话中追加/检索记忆与知识片段；已验证 155★，更新于 2025-07-02。

**Best for:** 想自托管共享记忆层并通过 MCP 让 agent 调用的开发者

**Works with:** 需要 Docker Compose、Go 1.21+、Python 3.13+（README 前置条件）；HTTP 服务默认 :8080

**Setup time:** 25-50 minutes

### Key facts (verified)

- GitHub：155 stars · 11 forks；最近更新 2025-07-02。
- 许可证：AGPL-3.0；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中可对照的入口命令：`./eion-server`。

## Main

- 先把存储跑起来：README 以 `docker-compose up -d` 启动 Postgres+Neo4j，并要求启用 pgvector 扩展。

- 先验健康再接入：`./eion-server` 启动后先打 `/health`，把基础设施问题提前暴露。

- 用 MCP 做对话期记忆操作：README 给出 `python -m internal.mcp.server` + `EION_BASE_URL` 的接入方式。

- 把鉴权字段当必填：README 表示 MCP 工具调用需要 `session_id/agent_id/user_id`，先注册 agent 再调用工具。

### Source-backed notes

- README 列出前置：Docker Compose、Go 1.21+、Python 3.13+。
- README Quick Start 使用 `http://localhost:8080`，包含 `/health`，并提供 `/console/`（必须带结尾斜杠）。
- README 在 `eion.yaml` 中描述 MCP 配置（含默认 8081 端口），并强调 MCP 内嵌在 server 进程中。

### FAQ

- **需要单独部署 MCP 服务吗？**：README 说明 MCP server 内嵌在 Eion server 进程中，无需单独 daemon。
- **为什么 Console 要带结尾斜杠？**：README 明确提示访问 `http://localhost:8080/console/` 必须包含 `/`。
- **MCP 工具怎么鉴权？**：README 要求 `session_id/agent_id/user_id`，并需要先通过 Developer API 注册 agent。

## Source & Thanks

> Source: https://github.com/eiondb/eion
> License: AGPL-3.0
> GitHub stars: 155 · forks: 11


---
Source: https://tokrepo.com/en/workflows/eion-shared-memory-server-mcp-for-agents
Author: MCP Hub