Metadata-Version: 2.4
Name: ace-mcp-server
Version: 0.3.0
Summary: Ace MCP Server — Free AI memory that learns. Zero cloud, zero API keys, zero cost.
Author-email: Wenhui Tian <rocky007cn@outlook.com>
License: BSL-1.1
Project-URL: Homepage, https://github.com/rocky007cn/ace-memory
Project-URL: Repository, https://github.com/rocky007cn/ace-memory
Keywords: mcp,mcp-server,ai-memory,memory,llm,agent-memory,rag,long-term-memory,local-first,free,zero-cost
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: pvm-memory>=1.1.0
Requires-Dist: mcp>=1.0.0
Provides-Extra: semantic
Requires-Dist: sentence-transformers>=2.2.0; extra == "semantic"

# Ace MCP Server

♠ **Ace your AI memory. Free. Simple. Local.**

Zero-cost MCP server that gives any AI tool persistent, self-improving memory.

## Install

```bash
pip install ace-mcp
```

Requires `pvm-memory` (installed automatically as dependency).

## Quick Start

### VS Code / Cursor

Add to `.vscode/mcp.json`:

```json
{
  "servers": {
    "ace": {
      "command": "python",
      "args": ["-m", "ace_mcp.server"]
    }
  }
}
```

### Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "ace": {
      "command": "python",
      "args": ["-m", "ace_mcp.server"]
    }
  }
}
```

### Any MCP-compatible tool

```bash
ace-mcp                     # default: ~/.ace/memory.jsonl
ace-mcp --path ./my-mem.jsonl
ace-mcp --no-embedding      # keyword-only, faster
```

## Tools

| Tool | What |
|------|------|
| `ace_save` | Store a memory |
| `ace_search` | Keyword + semantic search |
| `ace_get_context` | Recent memory context |
| `ace_calibrate` | 👍/👎 feedback to train weights |
| `ace_stats` | Engine statistics |

## vs Mem0

| | Mem0 | Ace |
|---|---|---|
| Price | 💰 Paid | 🆓 Free |
| API Key | Required | None |
| Cloud | Required | 100% Local |
| GPU | Recommended | Not needed |
| Dependencies | 50+ | 2 |
| Information | Chunked/lossy | Full text |

## License

BSL 1.1 → MIT (2030)
