MCP Notes Connector

# MCP Notes Connector Evernote APIを利用したModel Context Protocol (MCP) サーバーの実装。 ## 概要 このプロジェクトは、Evernote APIとの統合を提供するMCPサーバーです。ノート、ノートブック、タグなどのEvernoteリソースへのアクセスを可能にします。 **現在の状態**: 基本構造は完成していますが、Evernote API連携部分は未実装（スタブ状態）です。 ## クイックスタート セットアップ方法と動作確認については、**[docs/QUICKSTART.md](docs/QUICKSTART.md)** を参照してください。 ## プロジェクト状況 詳細な実装状況、今後のロードマップについては、**[docs/STATUS.md](docs/STATUS.md)** を参照してください。 ## セットアップ ### 仮想環境の作成とパッケージのインストール ```bash # 仮想環境の作成 python -m venv venv # 仮想環境の有効化 # Windows: venv\Scripts\activate # Linux/Mac: source venv/bin/activate # 依存パッケージのインストール pip install -r requirements.txt # または開発版のインストール pip install -e ".[dev]" ``` ### 環境変数 `.env`ファイルを作成し、以下の環境変数を設定してください： ``` EVERNOTE_TOKEN=your_evernote_developer_token EVERNOTE_SANDBOX=true # サンドボックス環境を使用する場合 ``` ## 開発 ```bash # サーバー起動 python -m mcp_notes_connector.server # または mcp-notes-connector # pip install後 # テスト実行 pytest # コードフォーマット black src/ tests/ # Lint ruff check src/ tests/ # 型チェック mypy src/ ``` ## プロジェクト構造 ``` src/mcp_notes_connector/ ├── __init__.py # パッケージ初期化 ├── server.py # MCPサーバーのメインロジック ├── evernote_client.py # Evernote API クライアント └── types.py # 型定義 tests/ # テストコード docs/ ├── ARCHITECTURE.md # アーキテクチャ詳細 ├── STATUS.md # 実装状況とロードマップ └── QUICKSTART.md # セットアップガイド ``` ## ドキュメント ### ユーザー向け - **[docs/QUICKSTART.md](docs/QUICKSTART.md)** - 最速でセットアップして動作確認 - **[docs/STATUS.md](docs/STATUS.md)** - 実装状況、未実装項目、今後のロードマップ - **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)** - システムアーキテクチャの詳細 ### 開発者向け（AIエージェント用） - **[CLAUDE.md](CLAUDE.md)** - Claude Code向けの開発ガイド - **[AGENT.md](AGENT.md)** - AI Coding Agents（GitHub Copilot CLI等）向けガイド ## License MIT