mcpField
M
MCP Server Memos 📝

MCP Server Memos 📝

ローカル
github.com/RyoJerryYu生産性2155 週間前に更新

MCP Server Memos 📝 について

MCP Server Memos は、LLM が MCP を通じて Memos サーバーとやり取りし、メモの検索・作成・取得・管理を行えるようにする Python パッケージです。AI アシスタントから Memos を利用したいユーザー向けで、アクセストークンによる認証に対応しています。

主な機能

  1. 01キーワードによるメモ検索
  2. 02公開範囲を指定したメモ作成
  3. 03ID によるメモ内容の取得
  4. 04メモタグの一覧表示と管理
  5. 05アクセストークンによる認証

活用シーン

  1. 01AI アシスタントとの会話中に保存済みのメモを参照
  2. 02LLM から Memos へ新しい内容を記録
  3. 03タグ別のメモの整理と確認

MCP 対応

本プロジェクトは MCP サーバーであり、Memos サーバーにアクセスするためのツール list_memo_tags、search_memo、create_memo、get_memo を MCP クライアントに提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"memos-py": {
"command": "npx",
"args": [
"-y",
"@smithery/cli"
]
}
}
}
起動コマンドnpx -y @smithery/cli

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@smithery/cli

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

MseeP.ai Security Assessment Badge

MCP Server Memos 📝

PyPI version Python Version License smithery badge

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)

🔧 設定

パラメーター説明デフォルト
hostMemos サーバーのホスト名localhost
portMemos サーバーのポート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_memoID を指定して特定のメモを取得- name: メモの名前/ID(形式:memos/{id})

🤝 コントリビューション

コントリビューションを歓迎します。お気軽に Pull Request を送信してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については、LICENSEファイルをご覧ください。

🙏 謝辞

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。