second-opinion-mcp 0.3.2__tar.gz → 0.3.4__tar.gz

{second_opinion_mcp-0.3.2 → second_opinion_mcp-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: second-opinion-mcp
-Version: 0.3.2
+Version: 0.3.4
 Summary: Multi-model AI analysis for Claude - get second opinions from DeepSeek, Kimi, and OpenRouter
 Project-URL: Homepage, https://github.com/MarvinFS/second-opinion-mcp
 Project-URL: Repository, https://github.com/MarvinFS/second-opinion-mcp
@@ -143,6 +143,56 @@ Full workflow: parallel reviews from both models, debate, then synthesis instruc
 Perform a comprehensive code review of ./myproject using review_synthesis
 ```
 
+## Usage Examples
+
+### Thorough Code Review Workflow
+
+For comprehensive code reviews, use this prompt pattern with Claude Code:
+
+```
+MyProject: perform a comprehensive deep parallel code review with deepseek and kimi
+using mcp server second-opinion - save resulting md files to the project folder
+to the docs subfolder in md format.
+
+After that perform Consensus debate + arbiter synthesis using same mcp server tools
+with opus 4.5 compiling a final document for the final review.
+
+First 2 tasks can be run in parallel.
+```
+
+This triggers parallel code_review calls to DeepSeek and Moonshot, then a consensus debate on findings, and finally Claude synthesizes the final review document.
+
+### Quick Second Opinion
+
+```
+Use second_opinion to review this database schema:
+CREATE TABLE users (
+  id SERIAL PRIMARY KEY,
+  email VARCHAR(255),
+  password VARCHAR(255)
+);
+```
+
+### Critical Challenge
+
+```
+Use challenge to critique this proposal: "We should use a global singleton for
+database connections because it's simpler"
+```
+
+### Consensus Debate
+
+```
+Use consensus to debate: "GraphQL vs REST for our internal microservices API"
+```
+
+### Code Review with Focus Areas
+
+```
+Use code_review on directory="./src" with focus_areas=["security", "error-handling"]
+and save_to="./docs/reviews"
+```
+
 ## Configuration
 
 ### Changing Providers
@@ -179,10 +229,23 @@ To update keys:
 second-opinion-mcp setup
 ```
 
-Or manually:
+Or manually set each provider's key:
+
+```bash
+# DeepSeek (key starts with sk-)
+python3 -c "import keyring; keyring.set_password('second-opinion', 'deepseek', 'sk-YOUR_DEEPSEEK_KEY')"
+
+# Moonshot/Kimi
+python3 -c "import keyring; keyring.set_password('second-opinion', 'moonshot', 'YOUR_MOONSHOT_KEY')"
+
+# OpenRouter (key starts with sk-or-)
+python3 -c "import keyring; keyring.set_password('second-opinion', 'openrouter', 'sk-or-YOUR_OPENROUTER_KEY')"
+```
+
+Verify keys are configured:
 
 ```bash
-python -c "import keyring; keyring.set_password('second-opinion', 'deepseek', 'sk-YOUR_NEW_KEY')"
+python3 -c "import keyring; print('deepseek:', bool(keyring.get_password('second-opinion', 'deepseek'))); print('moonshot:', bool(keyring.get_password('second-opinion', 'moonshot'))); print('openrouter:', bool(keyring.get_password('second-opinion', 'openrouter')))"
 ```
 
 ### Claude Desktop Configuration
@@ -308,8 +371,9 @@ claude mcp remove second-opinion
 pipx uninstall second-opinion-mcp
 
 # Optional: remove stored API keys
-python -c "import keyring; keyring.delete_password('second-opinion', 'deepseek')"
-python -c "import keyring; keyring.delete_password('second-opinion', 'moonshot')"
+python3 -c "import keyring; keyring.delete_password('second-opinion', 'deepseek')"
+python3 -c "import keyring; keyring.delete_password('second-opinion', 'moonshot')"
+python3 -c "import keyring; keyring.delete_password('second-opinion', 'openrouter')"
 ```
 
 ## Security

{second_opinion_mcp-0.3.2 → second_opinion_mcp-0.3.4}/README.md

@@ -105,6 +105,56 @@ Full workflow: parallel reviews from both models, debate, then synthesis instruc
 Perform a comprehensive code review of ./myproject using review_synthesis
 ```
 
+## Usage Examples
+
+### Thorough Code Review Workflow
+
+For comprehensive code reviews, use this prompt pattern with Claude Code:
+
+```
+MyProject: perform a comprehensive deep parallel code review with deepseek and kimi
+using mcp server second-opinion - save resulting md files to the project folder
+to the docs subfolder in md format.
+
+After that perform Consensus debate + arbiter synthesis using same mcp server tools
+with opus 4.5 compiling a final document for the final review.
+
+First 2 tasks can be run in parallel.
+```
+
+This triggers parallel code_review calls to DeepSeek and Moonshot, then a consensus debate on findings, and finally Claude synthesizes the final review document.
+
+### Quick Second Opinion
+
+```
+Use second_opinion to review this database schema:
+CREATE TABLE users (
+  id SERIAL PRIMARY KEY,
+  email VARCHAR(255),
+  password VARCHAR(255)
+);
+```
+
+### Critical Challenge
+
+```
+Use challenge to critique this proposal: "We should use a global singleton for
+database connections because it's simpler"
+```
+
+### Consensus Debate
+
+```
+Use consensus to debate: "GraphQL vs REST for our internal microservices API"
+```
+
+### Code Review with Focus Areas
+
+```
+Use code_review on directory="./src" with focus_areas=["security", "error-handling"]
+and save_to="./docs/reviews"
+```
+
 ## Configuration
 
 ### Changing Providers
@@ -141,10 +191,23 @@ To update keys:
 second-opinion-mcp setup
 ```
 
-Or manually:
+Or manually set each provider's key:
+
+```bash
+# DeepSeek (key starts with sk-)
+python3 -c "import keyring; keyring.set_password('second-opinion', 'deepseek', 'sk-YOUR_DEEPSEEK_KEY')"
+
+# Moonshot/Kimi
+python3 -c "import keyring; keyring.set_password('second-opinion', 'moonshot', 'YOUR_MOONSHOT_KEY')"
+
+# OpenRouter (key starts with sk-or-)
+python3 -c "import keyring; keyring.set_password('second-opinion', 'openrouter', 'sk-or-YOUR_OPENROUTER_KEY')"
+```
+
+Verify keys are configured:
 
 ```bash
-python -c "import keyring; keyring.set_password('second-opinion', 'deepseek', 'sk-YOUR_NEW_KEY')"
+python3 -c "import keyring; print('deepseek:', bool(keyring.get_password('second-opinion', 'deepseek'))); print('moonshot:', bool(keyring.get_password('second-opinion', 'moonshot'))); print('openrouter:', bool(keyring.get_password('second-opinion', 'openrouter')))"
 ```
 
 ### Claude Desktop Configuration
@@ -270,8 +333,9 @@ claude mcp remove second-opinion
 pipx uninstall second-opinion-mcp
 
 # Optional: remove stored API keys
-python -c "import keyring; keyring.delete_password('second-opinion', 'deepseek')"
-python -c "import keyring; keyring.delete_password('second-opinion', 'moonshot')"
+python3 -c "import keyring; keyring.delete_password('second-opinion', 'deepseek')"
+python3 -c "import keyring; keyring.delete_password('second-opinion', 'moonshot')"
+python3 -c "import keyring; keyring.delete_password('second-opinion', 'openrouter')"
 ```
 
 ## Security

{second_opinion_mcp-0.3.2 → second_opinion_mcp-0.3.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "second-opinion-mcp"
-version = "0.3.2"
+version = "0.3.4"
 description = "Multi-model AI analysis for Claude - get second opinions from DeepSeek, Kimi, and OpenRouter"
 requires-python = ">=3.10"
 readme = "README.md"

{second_opinion_mcp-0.3.2 → second_opinion_mcp-0.3.4}/src/second_opinion_mcp/__init__.py

@@ -1,6 +1,6 @@
 """Second Opinion MCP Server - Multi-model AI analysis for Claude."""
 
-__version__ = "0.3.2"
+__version__ = "0.3.4"
 __author__ = "MarvinFS"
 
 from second_opinion_mcp.server import mcp, second_opinion, challenge, code_review, consensus, review_synthesis

{second_opinion_mcp-0.3.2 → second_opinion_mcp-0.3.4}/src/second_opinion_mcp/cli.py

@@ -149,12 +149,12 @@ def print_manual_setup_instructions(providers: list[str] | None = None):
     for provider in target_providers:
         config = PROVIDERS[provider]
         print(f"  # {config['name']} - Get key at {config['key_hint']}")
-        print(f"  python -c \"import keyring; keyring.set_password('{config['keyring_service']}', '{config['keyring_name']}', 'YOUR_API_KEY')\"")
+        print(f"  python3 -c \"import keyring; keyring.set_password('{config['keyring_service']}', '{config['keyring_name']}', 'YOUR_API_KEY')\"")
         print()
 
     print("To verify your keys are stored:")
     print()
-    print("  python -c \"import keyring; print('deepseek:', bool(keyring.get_password('second-opinion', 'deepseek'))); print('moonshot:', bool(keyring.get_password('second-opinion', 'moonshot')))\"")
+    print("  python3 -c \"import keyring; print('deepseek:', bool(keyring.get_password('second-opinion', 'deepseek'))); print('moonshot:', bool(keyring.get_password('second-opinion', 'moonshot')))\"")
     print()
     print("After configuring keys, register with Claude Code:")
     print()