使用说明
存储器MCP
用于OpenCode的本地内存MCP服务器-用于AI编码代理的持久内存层。
特性
- 仅本地内存存储(除嵌入外没有外部服务)
- FAISS向量搜索在语义记忆检索中的应用
- 用于元数据持久化的SQLite
- 用于与OpenCode集成的MCP协议
- 通过文件锁定进行并发访问
快速开始
# Set environment variables
export MEMORY_USER_ID=your_user_id
export EMBEDDING_PROVIDER=openai # or ollama, huggingface
export EMBEDDING_API_KEY=your_api_key
# Run the server
python -m memory_mcp.server
OpenCode配置
添加到您的OpenCode MCP配置文件中:
{
"mcp": {
"memory": {
"type": "local",
"enabled": true,
"command": ["uvx", "--from", "opencode-memory", "memory-mcp", "--stdio"],
"environment": {
"MEMORY_USER_ID": "user_name",
"MEMORY_DATA_DIR": "{env:HOME}/.memory",
"EMBEDDING_PROVIDER": "openai",
"EMBEDDING_API_KEY": "your_api_key"
}
}
}
}
或者通过pip安装后:
uvx opencode-memory
#!/bin/bash
export MEMORY_USER_ID=your_user_id
export MEMORY_DATA_DIR=./data
export EMBEDDING_PROVIDER=openai
export EMBEDDING_API_KEY=your_api_key
exec python -m memory_mcp.server
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
MEMORY_USER_ID |
是 | 操作的用户/实体ID |
MEMORY_DATA_DIR |
否 | 数据的基本目录(默认: ./data) |
EMBEDDING_PROVIDER |
是的 | openai, ollama,或 huggingface |
EMBEDDING_API_KEY |
没有用于嵌入服务的 | API密钥 |
EMBEDDING_BASE_URL |
否 | Ollama/HF的自定义端点 |
EMBEDDING_MODEL |
否 | 型号名称 |
EMBEDDING_DIMENSION |
否 | 矢量维度(默认值:1536) |
