snipara mcp
](https://pypi.org/project/snipara-mcp/)  
snipara-mcp 是Snipara的轻量级MCP连接器。
记忆属于项目,而不是模型。
当MCP客户端需要与Snipara通信的本地stdio进程时使用它 托管项目内存和上下文优化API。
什么是Snipara?
Snipara是AI辅助工作的项目范围持久上下文。
它为Claude Code、Cursor、Codex、OpenAI代理和其他MCP兼容提供了支持 客户端——一个在会话、用户、工具和模型中幸存的共享内存层 开关。
您的代理仍然使用自己的LLM。Snipara提供了正确的背景。
为什么选择MCP?
MCP正在成为代理工具的标准适配器层。 snipara-mcp 使 Snipara可以通过该层使用,而无需强迫开发人员进入特定的 IDE、模型或编排框架。
集成应该感觉很小:
uvx snipara-mcp影响更大:代理可以检索持久的项目上下文,而不是 每节课都冷着开始。
建筑
Claude Code Cursor Codex OpenAI Agents
| | | |
+---------------+--------------+------------------+
|
snipara-mcp
|
Hosted Snipara MCP API
|
Shared Project Memory
|
Compact Context for Your LLM托管HTTP还是Stdio?
当您的MCP客户端支持流式HTTP时,使用托管的HTTP端点:
{
"mcpServers": {
"snipara": {
"type": "http",
"url": "https://api.snipara.com/mcp/your-project-id-or-slug",
"headers": {
"Authorization": "Bearer rlm_your_api_key"
}
}
}
}使用 snipara-mcp 当您的客户端需要本地stdio命令时:
{
"mcpServers": {
"snipara": {
"command": "uvx",
"args": ["snipara-mcp"],
"env": {
"SNIPARA_API_KEY": "rlm_your_api_key",
"SNIPARA_PROJECT_ID": "your-project-id-or-slug"
}
}
}
}安装
无本地安装:
uvx snipara-mcpPython包:
pip install snipara-mcp通过RLM运行时助手集成:
pip install "snipara-mcp[rlm]"快速入门
通过浏览器登录:
pip install snipara-mcp
snipara login初始化项目:
snipara init初始化器检测通用项目文件,写入MCP配置,并可以 通过身份验证后上传本地项目文档。
有用的选项:
snipara init --slug my-project
snipara init --dry-run
snipara init --no-upload
snipara init --skip-test克劳德代码
claude mcp add snipara -- uvx snipara-mcp然后在shell中导出凭据:
export SNIPARA_API_KEY="rlm_your_api_key"
export SNIPARA_PROJECT_ID="your-project-id-or-slug"光标
添加 ~/.cursor/mcp.json:
{
"mcpServers": {
"snipara": {
"command": "uvx",
"args": ["snipara-mcp"],
"env": {
"SNIPARA_API_KEY": "rlm_your_api_key",
"SNIPARA_PROJECT_ID": "your-project-id-or-slug"
}
}
}
}环境
| 变量 | 必填 | 描述 |
|---|---|---|
SNIPARA_API_KEY | 是的,除非使用 snipara login | Snippara API密钥 |
SNIPARA_PROJECT_ID | 是的,除非使用 SNIPARA_PROJECT_SLUG | 项目标识符 |
SNIPARA_PROJECT_SLUG | 是的,除非使用 SNIPARA_PROJECT_ID | 项目段塞 |
SNIPARA_API_URL | 否 | 默认为 https://api.snipara.com |
由创建的OAuth令牌 snipara login 存储在 ~/.snipara/tokens.json. 如果设置了项目id或slug,连接器将选择匹配的令牌 不会默默地回到另一个项目。
所得
连接器公开了与托管后端相同的MCP契约。包装 工具表面是从服务器真实源生成的。
常用工具组:
- 检索:
rlm_context_query,rlm_search,rlm_get_chunk,rlm_load_document - 持久记忆:
rlm_recall,rlm_remember,rlm_memory_compact - 共享上下文:
rlm_shared_context,收集和模板工具 - 文档上传:
rlm_upload_document,rlm_sync_documents - 项目设置:客户端、项目和业务上下文工作区工具
- 操作:
rlm_settings,rlm_index_health,rlm_reindex - 代码图:
rlm_code_*代码索引可用时的工具 - 协调:启用群集、分层任务和状态工具
工具可用性可能因计划、托管部署和项目索引状态而异。
CLI命令
| 命令 | 描述 |
|---|---|
snipara login | 浏览器登录和令牌设置 |
snipara init | 在当前项目中初始化Snipara |
snipara logout | 清除存储的令牌 |
snipara status | 显示身份验证和项目状态 |
snipara-mcp | 运行MCP stdio服务器 |
传统别名,如 snipara-init, snipara-mcp-login, snipara-mcp-logout,以及 snipara-mcp-status 仍然受到支持。
与其他仓库的关系
| 代表 | 角色 |
|---|---|
Snipara/snipara-server | 托管和自托管服务器界面 |
alopez3006/snipara-mcp | 此stdio连接器包 |
Snipara/snipara-memory | 开放式内存原语和模式 |
snipara-mcp 故意变薄。它应该易于安装,易于 审计,操作无聊。繁重的工作仍由Snipara主持 上下文和内存引擎。
发展
pip install -e ".[dev]"
pytest
ruff check .生成的工具合同的真相来源于Snipara 服务器。当后端工具发生更改时,请在之前重新生成打包的合约 发布此包。
许可证
MIT。看 许可证.
