memos-mcp-server

🚀 Memos MCP 服务器

这是一个 Model Context Protocol (MCP) 服务器，其作用是将 Memos 集成到支持 MCP 协议的 AI 助手（例如 Claude）中。

✨ 主要特性

• 可使用关键词搜索笔记。
• 能够创建新的笔记，并且可以自定义可见性设置和标签。
• 可根据 ID 获取特定笔记。
• 能获取用户信息。

🚀 快速开始

📦 安装指南

Claude Desktop 设置

1. 安装 Claude Desktop
   • 下载 Claude Desktop。
   • 确保使用的是最新版本（菜单：Claude -> 检查更新...）。
2. 配置 MCP 服务器

   {
     "mcpServers": {
       "memos": {
         "command": "npx",
         "args": [
           "memos-mcp-server"
         ],
         "env": {
           "MEMOS_URL": "https://your-memos-instance.com",
           "MEMOS_API_KEY": "your_api_key"
         }
       }
     }
   }
   

📚 详细文档

🛠️ 可用工具

search_memo

使用关键词搜索笔记。 参数： | 属性 | 详情 | | ---- | ---- | | key_word | 字符串类型，在笔记内容中搜索的关键词 | | state | 字符串类型，可选，笔记的状态（默认："NORMAL"，也可以是 "ARCHIVED"） |

create_memo

创建新的笔记。 参数： | 属性 | 详情 | | ---- | ---- | | content | 字符串类型，笔记内容 | | visibility | 字符串类型，可选，可见性设置（默认："PRIVATE"，选项："PUBLIC", "PROTECTED", "PRIVATE"） | | tags | 字符串数组类型，可选，笔记的标签列表 |

get_memo

根据 ID 获取特定笔记。 参数： | 属性 | 详情 | | ---- | ---- | | name | 字符串类型，笔记名称，格式为 memos/{id} 或仅数字形式的 ID |

get_user

获取当前用户信息。

🔧 技术细节

🧪 开发

该项目运用 TypeScript 和 FastMCP 框架进行 MCP 服务器开发。

设置

# 安装依赖项
npm install

# 复制示例环境文件并设置环境变量
cp .env.example .env
# 编辑 .env 文件以配置 Memos API 的详细信息

开发模式

npm run dev

构建

npm run build

生产服务器运行

npm start

使用 mcp-cli 测试

最快的方式是使用 mcp-cli 进行测试和调试你的服务器：

npx fastmcp dev src/server.ts

这是使用 mcp-cli 在终端中测试和调试你的 MCP 服务器的快速方法。

使用 MCP Inspector 检查

你还可以使用官方的 MCP Inspector 通过 Web UI 检查你的服务器：

npx fastmcp inspect src/server.ts

🤝 贡献

欢迎贡献、问题和功能请求！你可以访问 issues 页面。

📄 许可证

MIT License - 版权所有 (c) 2025 Stephen J. Li