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エージェント用）

CLAUDE.md - Claude Code向けの開発ガイド
AGENT.md - AI Coding Agents（GitHub Copilot CLI等）向けガイド

License

MIT

概要

現在の状態: 基本構造は完成していますが、Evernote API連携部分は未実装（スタブ状態）です。

セットアップ

仮想環境の作成とパッケージのインストール

# 仮想環境の作成 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エージェント用）

CLAUDE.md - Claude Code向けの開発ガイド

AGENT.md - AI Coding Agents（GitHub Copilot CLI等）向けガイド