Provides access to Evernote resources including notes, notebooks, and tags through the Evernote API.
MCP Notes Connector
Evernote APIを利用したModel Context Protocol (MCP) サーバーの実装。
概要
このプロジェクトは、Evernote APIとの統合を提供するMCPサーバーです。ノート、ノートブック、タグなどのEvernoteリソースへのアクセスを可能にします。
現在の状態: 基本構造は完成していますが、Evernote API連携部分は未実装（スタブ状態）です。
クイックスタート
セットアップ方法と動作確認については、docs/QUICKSTART.md を参照してください。
プロジェクト状況
詳細な実装状況、今後のロードマップについては、docs/STATUS.md を参照してください。
セットアップ
仮想環境の作成とパッケージのインストール
# 仮想環境の作成
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 # サンドボックス環境を使用する場合
開発
# サーバー起動
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/STATUS.md - 実装状況、未実装項目、今後のロードマップ
docs/ARCHITECTURE.md - システムアーキテクチャの詳細
開発者向け（AIエージェント用）
License
MIT
This server cannot be installed