Memos MCP 服务器

一个 模型上下文协议 (MCP) 服务器，用于将 Memos 与支持 MCP 协议的 AI 助手（如 Claude）集成。

✨ 功能

• 使用关键词搜索备忘录
• 创建具有可自定义可见性设置和标签的新备忘录
• 通过 ID 检索特定备忘录
• 获取用户信息

🚀 安装

Claude 桌面版设置

1. 安装 Claude 桌面版

   • 下载 Claude 桌面版
   • 确保您拥有最新版本（菜单：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

# 创建 .env 文件并设置环境变量
cp .env.example .env
# 使用您的 Memos API 详细信息编辑 .env 文件

开发模式

npm run dev

构建

npm run build

运行生产服务器

npm start

使用 mcp-cli 测试

测试和调试服务器的最快方法是使用 fastmcp dev：

npx fastmcp dev src/server.ts

这将使用 mcp-cli 运行您的服务器，以便在终端中测试和调试您的 MCP 服务器。

使用 MCP Inspector 检查

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

npx fastmcp inspect src/server.ts

🤝 贡献

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

📄 许可证

MIT 许可证 - 版权所有 (c) 2025 Stephen J. Li