Orly MCP

🚀 orly-mcp

orly-mcp 是一個 MCP（模型上下文協議）服務器，用於生成 O'RLY?（O'Reilly 仿作）書籍封面，並可直接在 Claude Desktop 應用程序中顯示。

🚀 快速開始

在 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' 的書籍封面"
• "為 'CSS Grid Mastery' 創建一個主題為 7 且圖像編號為 15 的 O'RLY 封面"

✨ 生成的書籍封面圖像將直接顯示在聊天中！

該工具支持以下參數：

📄 許可證

本項目採用 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 兼容，集成到 MCP 工具中，以便與 Claude Desktop 等 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 令牌，或將其設置為環境變量。