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

使用關鍵詞搜索筆記。 參數：

create_memo

創建新的筆記。 參數：

get_memo

根據 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