# 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