MCP Server POC

MCP Note Taker（POC）

AI アシスタントのノート作成向けに、ノート管理用のカスタムツールとリソースを備えた Model Context Protocol（MCP）サーバーを実装した概念実証です。

概要

このプロジェクトでは、Claude、Cursor など、MCP に対応する AI アシスタントにノート作成機能を提供する Model Context Protocol（MCP）サーバーの作成方法と使用方法を紹介します。サーバーには、次の機能が含まれています。

• ノートを追加するツール
• 最新のノートを取得するリソース
• すべてのノートを要約するプロンプト

すべてのノートは、プロジェクトディレクトリ内のローカルファイル notes.txt に保存されます。

要件

• Python 3.11
• requirements.txt に記載されている必須パッケージ

インストールとセットアップ

1. このリポジトリをクローンします。

git clone https://github.com/yourusername/mcp-server-poc.git
cd mcp-server-poc

2. 仮想環境を作成して有効化します。

# Init uv package manager 
uv init

# Create a Python 3.11 virtual environment
uv venv

# Activate on Windows
 .venv\Scripts\activate

# Activate on macOS/Linux
source venv/bin/activate

3. 必須パッケージをインストールします。

uv pip install -r requirements.txt

4. （任意）開発や別の統合方法で必要な場合は、MCP CLI ツールをインストールします。

uv add "mcp[cli]"

アプリケーションの実行

MCP サーバーを実行するには、次のコマンドを実行します。

uv run mcp

サーバーが起動し、stdio トランスポート方式で接続を待機します。

Cursor との統合

この MCP サーバーを Cursor IDE で使用するには、次の手順に従います。

1. ファイル ~/.cursor/mcp.json（Windows の場合：C:\Users\<username>\.cursor\mcp.json）を作成するか編集し、次の内容を記述します。

{
    "mcpServers": {
        "mcp-server": {
            "command": "python", 
            "args": [
                "ABSOLUTE/PATH/TO/main.py"
            ]
        }
    }
}

2. パスを main.py ファイルの絶対パスに置き換えます。

   • Windows の場合は、二重のバックスラッシュを使用します：C:\\Users\\username\\path\\to\\main.py
   • macOS/Linux の場合は、通常のスラッシュを使用します：/Users/username/path/to/main.py

3. MCP サーバーを読み込むため、バックグラウンドプロセスもすべて終了したうえで Cursor を完全に再起動します。

機能

ツール

• add_note(note: str)：notes.txt ファイルにノートを追加し、確認メッセージを返します。

リソース

• notes://latest：notes.txt ファイルから最新のノートを返します。まだノートがない場合は、その旨を知らせるメッセージを返します。

プロンプト

• note_summary_prompt()：notes.txt 内の現在のノートをすべて要約するよう AI に求めるプロンプトを生成します。

技術的な詳細

• すべてのノートは、プロジェクトのルートにある notes.txt というプレーンテキストファイルに保存されます。このファイルは、存在しない場合に自動作成されます。
• サーバーは Model Context Protocol SDK と mcp[cli] 依存関係を使用します。

Windows のバイナリモードに関する修正

Windows で stdio トランスポートを使用する場合、stdin/stdout のバイナリモードを設定する必要があることがあります。詳しくは MCP documentation を参照してください。

トラブルシューティング

• 必須パッケージがすべてインストールされていることを確認します（pip list で確認できます）。
• 設定ファイルに記載された絶対パスが正しいことを確認します。
• MCP サーバーが適切なバージョンの Python（3.11）で実行されていることを確認します。
• 問題が発生した場合は、MCP サーバーを直接実行してエラー出力を確認してください。

ライセンス

MIT License

謝辞

• このプロジェクトでは Model Context Protocol SDK を使用しています。