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 - Copyright (c) 2025 Stephen J. Li