MCP Toolz

Name: MCP Tools
Author: taylorleese

mcp-name: io.github.taylorleese/mcp-toolz

GitHub issues GitHub last commit codecov PyPI version Python MCP License: MIT

pre-commit OpenSSF Best Practices OpenSSF Scorecard Dependabot

Claude Code用のMCPサーバーで、マルチLLMフィードバックツールとクリップボード画像キャプチャ機能を提供します。

特徴

マルチLLMフィードバック: ChatGPT (OpenAI)、Claude (Anthropic)、Gemini (Google)、DeepSeekからセカンドオピニオンを取得可能
クリップボード画像キャプチャ: macOSのクリップボードから画像を直接Claude Codeに貼り付けて分析可能
MCP統合: Model Context Protocolを介してClaude Codeと連携

クイックスタート

インストール

PyPIから (推奨)

pip install mcp-toolz

ソースから (開発用)

# Clone the repository
git clone https://github.com/taylorleese/mcp-toolz.git
cd mcp-toolz

# Create and activate virtual environment
python3 -m venv venv
source venv/bin/activate  # macOS/Linux
# or: venv\Scripts\activate  # Windows

# Install in editable mode with dev dependencies
pip install -e ".[dev]"

設定

# Set your API keys as environment variables (at least one required for AI feedback tools)
export OPENAI_API_KEY=sk-...           # For ChatGPT
export ANTHROPIC_API_KEY=sk-ant-...    # For Claude
export GOOGLE_API_KEY=...              # For Gemini
export DEEPSEEK_API_KEY=sk-...         # For DeepSeek

# Or create a .env file (if installing from source)
cp .env.example .env
# Edit .env and add your API keys

MCPサーバーのセットアップ

Claude CodeのMCP設定に追加してください:

pip経由でインストールした場合:

{
  "mcpServers": {
    "mcp-toolz": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "env": {
        "OPENAI_API_KEY": "sk-...",
        "ANTHROPIC_API_KEY": "sk-ant-...",
        "GOOGLE_API_KEY": "...",
        "DEEPSEEK_API_KEY": "sk-..."
      }
    }
  }
}

ソースからインストールした場合:

{
  "mcpServers": {
    "mcp-toolz": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "cwd": "/absolute/path/to/mcp-toolz",
      "env": {
        "PYTHONPATH": "/absolute/path/to/mcp-toolz/src"
      }
    }
  }
}

Claude Codeを再起動してMCPサーバーを読み込みます。

MCPサーバーツール

AIフィードバックツール

コード、アーキテクチャの決定、実装計画について、複数のLLMからセカンドオピニオンを取得します:

ask_chatgpt - ChatGPTの分析を取得 (カスタム質問をサポート)
ask_claude - Claudeの分析を取得 (カスタム質問をサポート)
ask_gemini - Geminiの分析を取得 (カスタム質問をサポート)
ask_deepseek - DeepSeekの分析を取得 (カスタム質問をサポート)

クリップボード画像ツール

paste_image - macOSのクリップボードから画像をキャプチャして分析 (オプションの質問をサポート)

Claude Codeスキル

`/resolve-github-alerts`

GitHubのセキュリティアラート（Dependabot、コードスキャン、シークレットスキャン）を自動的にトリアージおよび解決します。Claude Codeで実行すると以下のことが可能です:

失敗しているDependabot PRの修正 (lint/テストの問題)
脆弱性のある依存関係の更新と要件の再コンパイル
コードスキャンおよびシークレットスキャンアラートの修正
手動レビュー用にすべての修正を含む単一のPRを提出

/resolve-github-alerts

使用例

複数のAIの視点を取得する

I'm deciding between Redis and Memcached for caching user sessions.
Ask ChatGPT for their analysis.

続けて以下のように質問できます:

"Ask Claude the same question for comparison"
"Ask Gemini for another perspective"
"What does DeepSeek think about this?"

クリップボードの画像を分析する

画像をクリップボードにコピー（スクリーンショット、図、エラーメッセージなど）してから、以下を実行します:

Analyze my clipboard image

または、特定の質問を添えて:

What's wrong with the UI layout in my clipboard image?

複数の視点でデバッグする

I'm getting "TypeError: Cannot read property 'map' of undefined" in my React component.
The error occurs in UserList.jsx when rendering the users array.
Ask ChatGPT and Claude for debugging suggestions.

環境変数

# Required (at least one for AI feedback tools)
OPENAI_API_KEY=sk-...                              # Your OpenAI API key
ANTHROPIC_API_KEY=sk-ant-...                       # Your Anthropic API key
GOOGLE_API_KEY=...                                 # Your Google API key (for Gemini)
DEEPSEEK_API_KEY=sk-...                            # Your DeepSeek API key

# Optional
MCP_TOOLZ_MODEL=gpt-5                                         # OpenAI model (default: gpt-5)
MCP_TOOLZ_CLAUDE_MODEL=claude-sonnet-4-5-20250929             # Claude model
MCP_TOOLZ_GEMINI_MODEL=gemini-2.0-flash-thinking-exp-01-21   # Gemini model
MCP_TOOLZ_DEEPSEEK_MODEL=deepseek-chat                        # DeepSeek model

トラブルシューティング

"Error 401: Invalid API key"

.envファイルまたは環境変数にAPIキーが設定されているか確認してください
APIプロバイダーのアカウントで課金が有効になっているか確認してください

"No module named context_manager"

Pythonを直接実行する前に PYTHONPATH=src を使用してください
または pip install mcp-toolz でインストールしてください

"No image found in clipboard"

最初に画像をコピーしてください（スクリーンショット、右クリック > 画像をコピーなど）
paste_image ツールはmacOSが必要です（AppleScriptを使用してクリップボードを読み取ります）

プロジェクト構造

mcp-toolz/
├── src/
│   ├── mcp_server/              # MCP server for Claude Code
│   │   └── server.py            # MCP tools and handlers
│   └── context_manager/         # Client implementations
│       ├── openai_client.py     # ChatGPT API client
│       ├── anthropic_client.py  # Claude API client
│       ├── gemini_client.py     # Gemini API client
│       ├── deepseek_client.py   # DeepSeek API client
│       └── clipboard.py         # macOS clipboard image capture
├── tests/                       # pytest tests
├── requirements.in
└── requirements.txt

開発

コントリビューター向けセットアップ

# Clone and install
git clone https://github.com/taylorleese/mcp-toolz.git
cd mcp-toolz
python3 -m venv venv
source venv/bin/activate
pip install -r requirements-dev.txt

# Install pre-commit hooks (IMPORTANT!)
pre-commit install

# Copy and configure .env
cp .env.example .env
# Edit .env with your API keys

テストの実行

source venv/bin/activate
pytest

コード品質

pre-commit Code style: black Ruff mypy isort security: bandit

# Run all checks (runs automatically on commit after pre-commit install)
pre-commit run --all-files

# Individual tools
black .
ruff check .
mypy src/

ライセンス

MIT

MCP Tools