Notes MCP Server

🚀 ノート MCP サーバー

このサーバーは、AI アシスタントとデータベースの間のインタラクションを可能にするモデルコンテキストプロトコル (MCP) サーバーです。安全かつ構造化された方法でノートの CRUD 操作を実行し、apach ignite を使用してデータを永続化します。

✨ 主な機能

• list_resources：データベース内のすべてのノートをリストする
• read_resource：データベースから1つのノートを読み取る
• list_tools：AI アシスタントがアクセスできるツールをリストする
• call_tool：ツールを実行する（ノートの作成または削除）
• list_prompts：いくつかの提案ヒントのリストを提供する
• get_prompt：具体的なヒント内容を表示する

📦 インストール

前提条件

• Python と uv パッケージマネージャーがインストールされていること
• MCP サーバーの依存関係がインストールされていること
• Apache Ignite がインストールされていること

手順

# リポジトリをクローンする
git clone https://github.com/coilybits/notes-mcp-server.git
cd notes-mcp-server

# 仮想環境を作成する
uv venv
source venv/bin/activate 

# 開発用の依存関係をインストールする
uv sync

🔧 設定

• --host：データベースが配置されているホストのアドレス
• --port：データベース接続のポート番号

💻 使用例

Continue.dev

Continue.dev で MCP サーバーを設定するには、以下のようにします。

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "/path/to/uv",
          "args": [
            "--directory",
            "/path/to/notes-mcp-server",
            "run",
            "main.py"
          ]
        }
      }
    ]
  }
}

Claude Desktop

Claude の設定ファイルに MCP サーバーを追加するには、以下のようにします。

{
  "mcpServers": {
    "messaging": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/path/to/notes-mcp-server",
        "run",
        "main.py", "--host=127.0.0.1", "--port=10800"
      ]
    }
  }
}

デバッグ

MCP Inspector を使用してデバッグするには、以下のコマンドを実行します。

npx @modelcontextprotocol/inspector uv \
--directory \
/path/to/notes-mcp-server \
run \
main.py

📄 ライセンス

MIT License - 詳細は LICENSE を参照してください。