Orly MCP

🚀 orly - mcp

このプロジェクトは、Claude Desktopアプリケーション内に直接表示されるO'RLY?（O'Reillyパロディ）の本の表紙を生成するためのMCP（Model Context Protocol）サーバーです。

🚀 クイックスタート

MCPサーバーへのインストール

以下をあなたのMCP設定に追加するだけです。

// ... 他のMCPサーバー ...
"mcp-orly": {
    "command": "uvx",
    "args": [
        "orly-mcp@latest"
    ]
}
// ... 他のMCPサーバー ...

ローカル開発

# リポジトリをクローンする
git clone [your-repo-url]
cd orly-mcp

# 仮想環境を作成し、依存関係をインストールする
uv venv .venv
uv pip install -r requirements.txt

# サンプル画像生成をテストする
uv run python test_mcp.py

# 包括的なテストを実行する
uv run python test_comprehensive.py

# 開発用のMCPサーバーを起動する
python start_server.py

📚 ドキュメント

Claude Desktopの設定

このMCPサーバーをClaude Desktopの設定ファイル（claude_desktop_config.json）に追加します。

推奨設定

{
  "mcpServers": {
    "orly-local": {
      "command": "uv",
      "args": [
        "run",
        "--with", "fastmcp",
        "--with", "pillow",
        "--with", "fonttools",
        "--with", "requests",
        "python",
        "/path/to/your/orly-mcp/orly_mcp/server.py"
      ],
      "cwd": "/path/to/your/orly-mcp"
    }
  }
}

重要: /path/to/your/orly-mcp を実際のプロジェクトパスに置き換えてください。

代替案: パッケージのインストール

# 編集可能モードでインストールする
uv pip install -e .

# Claude Desktopの設定
{
  "mcpServers": {
    "orly-local": {
      "command": "uvx",
      "args": ["--from", "/your/path/to/orly-mcp", "orly-mcp"]
    }
  }
}

トラブルシューティング

"ModuleNotFoundError: No module named 'mcp'" エラー

このエラーが表示された場合、MCPの依存関係が利用できないことを意味します。

cd /path/to/your/orly-mcp
uv pip install -r requirements.txt

Claude Desktopの設定に --with フラグですべての必要な依存関係が含まれていることを確認してください。

"ModuleNotFoundError: No module named 'fontTools'" エラー

Claude Desktopの設定にすべての依存関係が指定されていることを確認してください。

"args": [
  "run",
  "--with", "fastmcp",
  "--with", "pillow",
  "--with", "fonttools", 
  "--with", "requests",
  "python",
  "/your/path/to/orly_mcp/server.py"
]

セットアップのテスト

すべてが正常に動作することを確認するために、包括的なテストを実行します。

uv run python test_comprehensive.py

ClaudeでのORLYツールの使用

設定が完了すると、Claudeに以下のようにO'RLY本の表紙を生成するように依頼できます。

• "タイトルが 'Advanced Debugging' で著者が 'Jane Developer' のO'RLY本の表紙を作成して"
• "タイトルが 'Machine Learning Mistakes'、サブタイトルが 'What Could Go Wrong?'、著者が 'AI Enthusiast' の本の表紙を生成して"
• "テーマ7と画像15を使用して 'CSS Grid Mastery' のO'RLY表紙を作成して"

✨ 生成された本の表紙画像は、チャット内に直接表示されます！

このツールは以下のパラメータをサポートしています。

• title（必須）: 本のメインタイトル
• subtitle（オプション）: 表紙の上部に表示されるテキスト
• author（オプション）: 著者名（右下）
• image_code（オプション）: 動物/オブジェクトの画像1 - 40（指定しない場合はランダム）
• theme（オプション）: カラーテーマ0 - 16（指定しない場合はランダム）
• guide_text_placement（オプション）: ガイドテキストの位置 - 'top_left', 'top_right', 'bottom_left', 'bottom_right'
• guide_text（オプション）: カスタムガイドテキスト（デフォルトは "The Definitive Guide"）

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については LICENSE.txt ファイルを参照してください。

orly_generator/ ディレクトリ内の元のO'RLY本の表紙生成コードは、Charles Berlin（2016）の作品に基づいており、同じくMITライセンスの下でライセンスされています。詳細については orly_generator/LICENSE.txt を参照してください。

謝辞

このプロジェクトは、Charles Berlinの優れた作品に基づいています。orly_generator/ ディレクトリ内のコア画像生成コードは、彼の元の O - RLY - Book - Generator リポジトリから適応され、Python 3で動作するように更新され、Claude DesktopなどのMCPクライアントで使用するためのMCPツールに統合されています。

公開

（主に著者のChrisのための情報です。彼はPythonを使わないことが多く、これを忘れる可能性があります）

twineを使用して新しいバージョンをすぐに公開することができます。

uv run twine upload dist/*

PyPI APIトークンの入力を求められます。

# 開発用の依存関係をインストールする（buildとtwineを含む）
uv sync --group dev

# パッケージをビルドする
uv run python -m build

# ビルドされたパッケージをチェックする
uv run twine check dist/*

# テスト用にまずTestPyPIに公開する（オプション）
uv run twine upload --repository testpypi dist/*

# PyPIに公開する
uv run twine upload dist/*

以下のことを確認してください。

1. pyproject.toml 内のバージョン番号を更新する
2. uv run python test_comprehensive.py でパッケージをローカルでテストする
3. ビルドして公開する

認証には、~/.pypirc ファイルに設定されたPyPI APIトークンまたは環境変数が必要です。