second-opinion-mcp 0.3.1__tar.gz → 0.3.3__tar.gz

{second_opinion_mcp-0.3.1 → second_opinion_mcp-0.3.3}/.gitignore

@@ -50,3 +50,4 @@ Thumbs.db
 
 # Distribution / packaging
 MANIFEST
+second_opinion.py

{second_opinion_mcp-0.3.1 → second_opinion_mcp-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: second-opinion-mcp
-Version: 0.3.1
+Version: 0.3.3
 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
-python -c "import keyring; keyring.set_password('second-opinion', 'deepseek', 'sk-YOUR_NEW_KEY')"
+# DeepSeek (key starts with sk-)
+python -c "import keyring; keyring.set_password('second-opinion', 'deepseek', 'sk-YOUR_DEEPSEEK_KEY')"
+
+# Moonshot/Kimi
+python -c "import keyring; keyring.set_password('second-opinion', 'moonshot', 'YOUR_MOONSHOT_KEY')"
+
+# OpenRouter (key starts with sk-or-)
+python -c "import keyring; keyring.set_password('second-opinion', 'openrouter', 'sk-or-YOUR_OPENROUTER_KEY')"
+```
+
+Verify keys are configured:
+
+```bash
+python -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
@@ -279,6 +342,25 @@ Use code_review with focus_areas=["security", "error-handling", "performance"]
 Use code_review on directory="./src" with save_to="./docs/reviews"
 ```
 
+## Updating
+
+The server checks for updates on startup and notifies you if a new version is available.
+
+To update manually:
+
+```bash
+pipx upgrade second-opinion-mcp
+```
+
+Or reinstall:
+
+```bash
+pipx uninstall second-opinion-mcp
+pipx install second-opinion-mcp
+```
+
+Your API keys are preserved in the system keyring across updates.
+
 ## Uninstalling
 
 ```bash
@@ -291,6 +373,7 @@ 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')"
+python -c "import keyring; keyring.delete_password('second-opinion', 'openrouter')"
 ```
 
 ## Security

{second_opinion_mcp-0.3.1 → second_opinion_mcp-0.3.3}/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
-python -c "import keyring; keyring.set_password('second-opinion', 'deepseek', 'sk-YOUR_NEW_KEY')"
+# DeepSeek (key starts with sk-)
+python -c "import keyring; keyring.set_password('second-opinion', 'deepseek', 'sk-YOUR_DEEPSEEK_KEY')"
+
+# Moonshot/Kimi
+python -c "import keyring; keyring.set_password('second-opinion', 'moonshot', 'YOUR_MOONSHOT_KEY')"
+
+# OpenRouter (key starts with sk-or-)
+python -c "import keyring; keyring.set_password('second-opinion', 'openrouter', 'sk-or-YOUR_OPENROUTER_KEY')"
+```
+
+Verify keys are configured:
+
+```bash
+python -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
@@ -241,6 +304,25 @@ Use code_review with focus_areas=["security", "error-handling", "performance"]
 Use code_review on directory="./src" with save_to="./docs/reviews"
 ```
 
+## Updating
+
+The server checks for updates on startup and notifies you if a new version is available.
+
+To update manually:
+
+```bash
+pipx upgrade second-opinion-mcp
+```
+
+Or reinstall:
+
+```bash
+pipx uninstall second-opinion-mcp
+pipx install second-opinion-mcp
+```
+
+Your API keys are preserved in the system keyring across updates.
+
 ## Uninstalling
 
 ```bash
@@ -253,6 +335,7 @@ 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')"
+python -c "import keyring; keyring.delete_password('second-opinion', 'openrouter')"
 ```
 
 ## Security

{second_opinion_mcp-0.3.1 → second_opinion_mcp-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "second-opinion-mcp"
-version = "0.3.1"
+version = "0.3.3"
 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.1 → second_opinion_mcp-0.3.3}/src/second_opinion_mcp/__init__.py

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

{second_opinion_mcp-0.3.1 → second_opinion_mcp-0.3.3}/src/second_opinion_mcp/server.py

@@ -1575,6 +1575,42 @@ def _validate_startup_requirements() -> tuple[bool, str]:
     return True, ""
 
 
+def _check_for_updates() -> tuple[str | None, str | None]:
+    """Check PyPI for newer version of second-opinion-mcp.
+
+    Returns:
+        (latest_version, current_version) if update available, (None, None) otherwise.
+    """
+    import urllib.request
+    import json
+
+    try:
+        from second_opinion_mcp import __version__ as current_version
+    except ImportError:
+        current_version = "0.0.0"
+
+    try:
+        # Quick timeout to not delay startup
+        url = "https://pypi.org/pypi/second-opinion-mcp/json"
+        req = urllib.request.Request(url, headers={"User-Agent": "second-opinion-mcp"})
+        with urllib.request.urlopen(req, timeout=3) as response:
+            data = json.loads(response.read().decode())
+            latest_version = data.get("info", {}).get("version", "0.0.0")
+
+            # Simple version comparison (works for semver)
+            def parse_version(v: str) -> tuple[int, ...]:
+                return tuple(int(x) for x in v.split(".")[:3] if x.isdigit())
+
+            if parse_version(latest_version) > parse_version(current_version):
+                return latest_version, current_version
+
+    except Exception:
+        # Don't fail startup on update check errors
+        pass
+
+    return None, None
+
+
 def main():
     """Run the MCP server with stdio transport."""
     import sys
@@ -1585,6 +1621,13 @@ def main():
         format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
     )
 
+    # Check for updates (non-blocking, quick timeout)
+    latest, current = _check_for_updates()
+    if latest:
+        print(f"Update available: {current} -> {latest}", file=sys.stderr)
+        print("Run: pipx upgrade second-opinion-mcp", file=sys.stderr)
+        print(file=sys.stderr)
+
     # Validate minimum requirements
     ok, error = _validate_startup_requirements()
     if not ok: