MCP Server Memos 📝 について
MCP Server Memos は、LLM が MCP を通じて Memos サーバーとやり取りし、メモの検索・作成・取得・管理を行えるようにする Python パッケージです。AI アシスタントから Memos を利用したいユーザー向けで、アクセストークンによる認証に対応しています。
主な機能
- 01キーワードによるメモ検索
- 02公開範囲を指定したメモ作成
- 03ID によるメモ内容の取得
- 04メモタグの一覧表示と管理
- 05アクセストークンによる認証
活用シーン
- 01AI アシスタントとの会話中に保存済みのメモを参照
- 02LLM から Memos へ新しい内容を記録
- 03タグ別のメモの整理と確認
MCP 対応
本プロジェクトは MCP サーバーであり、Memos サーバーにアクセスするためのツール list_memo_tags、search_memo、create_memo、get_memo を MCP クライアントに提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
MCP Server Memos 📝
MCP(Model Context Protocol)インターフェースを通じて、LLM モデルがMemosサーバーと連携できるようにする Python パッケージです。
🚀 特長
- 🔍 キーワードでメモを検索
- ✨ 公開範囲をカスタマイズして新しいメモを作成
- 📖 ID でメモの内容を取得
- 🏷️ メモのタグを一覧表示・管理
- 🔐 アクセストークンを使用した安全な認証
🛠️ 使用方法
ほかの Python MCP プラグインと同様に、以下のように設定ファイルにこのパッケージを追加できます。
{
...,
"mcpServers": {
"fetch": { // other mcp servers
"command": "uvx",
"args": ["mcp-server-fetch"]
},
"memos": { // add this to your config
"command": "uvx",
"args": [
"--prerelease=allow",
"mcp-server-memos",
"--host",
"localhost",
"--port",
"5230",
"--token",
"your-access-token-here"
]
}
}
}
このパッケージのその他の使用方法
📦 インストール
Smithery 経由でのインストール
Smitheryを通じて、Claude Desktop に mcp-server-memos-py を自動的にインストールするには:
npx -y @smithery/cli install @RyoJerryYu/mcp-server-memos-py --client claude
手動インストール
pip install mcp-server-memos
コマンドライン
mcp-server-memos --host localhost --port 8080 --token YOUR_ACCESS_TOKEN
ライブラリとして
from mcp_server_memos import Config, serve_stdio
config = Config(
host="localhost",
port=8080,
token="YOUR_ACCESS_TOKEN"
)
await serve_stdio(config=config)
🔧 設定
| パラメーター | 説明 | デフォルト |
|---|---|---|
host | Memos サーバーのホスト名 | localhost |
port | Memos サーバーのポート | 8080 |
token | 認証用アクセストークン | "" |
🤝 利用可能なツール
この MCP サーバーでは、Memos と連携するために以下のツールを利用できます。
| ツール名 | 説明 | パラメーター |
|---|---|---|
list_memo_tags | 既存のメモタグをすべて一覧表示 | - parent: タグを所有する親(形式:memos/{id}、デフォルト:"memos/-")- visibility: タグの公開範囲(PUBLIC/PROTECTED/PRIVATE、デフォルト:PRIVATE) |
search_memo | キーワードでメモを検索 | - key_word: メモの内容から検索するキーワード |
create_memo | 新しいメモを作成 | - content: メモの内容- visibility: メモの公開範囲(PUBLIC/PROTECTED/PRIVATE、デフォルト:PRIVATE) |
get_memo | ID を指定して特定のメモを取得 | - name: メモの名前/ID(形式:memos/{id}) |
🤝 コントリビューション
コントリビューションを歓迎します。お気軽に Pull Request を送信してください。
📄 ライセンス
このプロジェクトは MIT ライセンスの下で公開されています。詳細については、LICENSEファイルをご覧ください。
🙏 謝辞
- Memos - 軽量でセルフホスト可能なメモハブ
- MCP(Model Context Protocol) - LLM アプリケーション向けのプロトコル
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。
