mem.ai MCP服务器
](https://www.npmjs.com/package/@hskksk/mem-ai-mcp-server) 
模型上下文协议（MCP）服务器 成员ai API集成。该服务器使像Claude这样的人工智能助手能够通过标准化的界面与您的mem.AI内存进行交互。
特性
- API全面覆盖：所有11个mem.ai API端点包装为MCP工具
- TypeScript：完全键入，启用严格模式
- 轻松集成：与Claude Desktop和其他MCP客户端无缝协作
- 错误处理：全面的错误处理和详细的消息
- 验证：使用Zod模式进行输入验证
安装
无需安装！您可以直接使用以下命令运行服务器 npx （推荐），或者如果您愿意，可以全局安装。
使用npx（推荐）
npx @hskksk/mem-ai-mcp-server这会自动下载并运行最新版本，无需安装。
全局安装（可选）
npm install -g @hskksk/mem-ai-mcp-server配置
获取API密钥
- 访问 mem.ai设置
- 生成新的API密钥
- 复制密钥进行配置
环境变量
创建一个 .env 文件或设置环境变量：
MEM_API_KEY=your_api_key_here可选配置：
# Override the default API base URL (default: https://api.mem.ai)
MEM_API_BASE_URL=https://api.mem.ai用法
使用克劳德桌面（推荐）
将以下配置添加到您的Claude Desktop配置文件中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"mem-ai": {
"command": "npx",
"args": ["-y", "@hskksk/mem-ai-mcp-server"],
"env": {
"MEM_API_KEY": "your_api_key_here"
}
}
}
}重新启动Claude Desktop后，您将能够在对话中使用mem.ai工具。
替代方案：使用全局安装
如果您已全局安装该软件包：
{
"mcpServers": {
"mem-ai": {
"command": "mem-ai-mcp-server",
"env": {
"MEM_API_KEY": "your_api_key_here"
}
}
}
}独立使用
# Using npx (recommended)
MEM_API_KEY=your_api_key_here npx @hskksk/mem-ai-mcp-server
# Or if installed globally
MEM_API_KEY=your_api_key_here mem-ai-mcp-server可用工具
Mem It
mem_it-智能地记住任何内容
- 用于将信息保存到mem.ai的主要端点 - 支持上下文和指令，以便更好地处理 - 参数： input （必填）， instructions, context, timestamp
票据管理
create_note-使用markdown内容创建新笔记
- 参数： content （必填）， id, collection_ids, collection_titles, created_at, updated_at
get_note-按ID检索特定钞票
- 参数： noteId （必填）
delete_note-删除注释
- 参数： noteId （必填）
list_notes-列出所有具有高级过滤和分页功能的笔记
- 支持基于光标的分页 page 和 next_page - 参数： - limit -最大结果数（默认值：50，最大值：100） - page -分页光标（来自上一页 next_page) - order_by -排序顺序： created_at 或 updated_at （默认值： updated_at) - collection_id -按集合ID筛选 - contains_open_tasks -使用打开的任务过滤笔记 - contains_tasks -过滤包含任何任务的笔记 - contains_images -用图像过滤笔记 - contains_files -使用文件/附件过滤笔记 - include_note_content -在响应中包含完整的降价内容
search_notes-使用高级过滤功能在笔记中搜索
- 参数： - query -搜索查询（可选） - filter_by_collection_ids -按集合ID数组筛选 - filter_by_contains_open_tasks -使用打开的任务过滤笔记 - filter_by_contains_tasks -过滤包含任何任务的笔记 - filter_by_contains_images -用图像过滤笔记 - filter_by_contains_files -使用文件过滤笔记 - config -响应配置(include_snippet, include_content)
收集管理
create_collection-创建新收藏
- 参数： title （必填）， description
get_collection-按ID检索特定集合
- 参数： collectionId （必填）
delete_collection-删除收藏
- 参数： collectionId （必填）
list_collections-列出所有带分页的集合
- 支持基于光标的分页 page 和 next_page - 参数： - limit -最大结果数（默认值：50，最大值：100） - page -分页光标（来自上一页 next_page) - order_by -排序顺序： created_at 或 updated_at （默认值： updated_at)
search_collections-跨收藏搜索
- 参数： - query -搜索查询（可选） - config -响应配置(include_description)
发展
先决条件
- Node.js>=20.0.0
- pnpm（推荐）或npm
设置
# Clone the repository
git clone https://github.com/hskksk/mem-ai-mcp-server.git
cd mem-ai-mcp-server
# Install dependencies
pnpm install
# Copy environment template
cp .env.example .env
# Edit .env and add your API key开发命令
# Run in development mode with auto-reload
pnpm dev
# Build the project
pnpm build
# Run tests
pnpm test
# Type check
pnpm type-check
# Lint
pnpm lint项目结构
src/
├── index.ts # Entry point
├── server.ts # MCP server setup
├── config/
│ └── env.ts # Environment configuration
├── client/
│ └── mem-api-client.ts # mem.ai API client
├── tools/ # MCP tool implementations
│ ├── base-tool.ts
│ ├── mem-it.ts
│ ├── notes/
│ └── collections/
├── types/ # TypeScript type definitions
└── utils/ # Utility functionsAPI文档
有关mem.ai API的详细信息，请访问 API官方文件.
错误处理
服务器为常见问题提供详细的错误消息：
- 401未经授权：API密钥无效
- 404未找到：未找到资源
- 429请求太多：超出费率限制
- 500服务器错误：内部服务器错误
所有错误都以结构化格式返回，便于调试。
贡献
欢迎投稿！请随时提交拉取请求。
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
链接
支持
如果您遇到任何问题或有疑问：
- 检查
- 创建包含详细信息的新问题
- 请参阅 mem.ai API文档
更新日志
看 更改日志.md 查看完整版本历史。