fixflow-mcp 1.0.2 → 1.0.4

package/README.md

@@ -17,24 +17,23 @@
 
 ---
 
-## ❌ Without FixFlow
-
-Your AI agent hits an error. It:
-- ❌ Googles it — finds 8 StackOverflow threads from 2017
-- ❌ Tries random solutions — some work, some break more things
-- ❌ Loses your flow state for 15+ minutes
-- ❌ **Forgets the fix** — next week, same problem, same 15 minutes wasted
-- ❌ The solution **dies with the chat session** — nobody else benefits
+## Without FixFlow vs With FixFlow (MCP)
+
+| | ❌ Without FixFlow | ✅ With FixFlow (MCP) |
+|---|---|---|
+| **Error detection** | You notice the error, copy it, ask the agent | Agent detects it **automatically mid-task** |
+| **Finding a fix** | Agent Googles → 8 irrelevant threads from 2017 | Agent calls `resolve_kb_id()` → **community-verified card in milliseconds** |
+| **Applying the fix** | Trial and error, might break more things | **Copy-paste verified command**, battle-tested by the community |
+| **Time to fix** | 15–30 minutes | **5–30 seconds** |
+| **Memory** | Fix dies with the chat session | Fix is saved **forever in the community KB** |
+| **Community effect** | Zero — your pain benefits nobody | **Every solved problem helps all future agents** |
+| **Next time** | Same 15 minutes. Again. | **0 seconds** — card is already there |
 
 With FixFlow, your agent **automatically detects the error, searches the community knowledge base, and applies the verified fix — before you even notice there was a problem.**  
 And if it's a new problem? It solves it, saves it, and **the entire community benefits forever.**
 
 ---
 
-## ⚡ Quick Start
-
-Add to your `claude_desktop_config.json` / `mcp_config.json`:
-
 ```json
 {
   "mcpServers": {
@@ -47,6 +46,21 @@ Add to your `claude_desktop_config.json` / `mcp_config.json`:
 }
 ```
 
+### ☁️ Option 2: Cloud Connection (No Install)
+
+Add directly without installing anything locally:
+
+```json
+{
+  "mcpServers": {
+    "fixflow-cloud": {
+      "command": "curl",
+      "args": ["-N", "-s", "https://adjacent-indigo-barnacle.fastmcp.app/mcp"]
+    }
+  }
+}
+```
+
 Add to your system prompt / `.cursorrules` / `.windsurfrules`:
 
 ```text

package/fastmcp_docs_server/requirements.txt

@@ -1,3 +1,5 @@
-fastmcp>=3.0.0rc1
+fastmcp[sse]
 PyYAML
 supabase>=2.0.0
+uvicorn
+starlette

package/fastmcp_docs_server/server.py

@@ -600,7 +600,25 @@ def get_kb_stats() -> str:
 
 def main():
     """CLI entry point for fixflow-mcp."""
-    mcp.run(transport='stdio')
+    import argparse
+    parser = argparse.ArgumentParser(description="FixFlow MCP Server")
+    parser.add_argument(
+        "transport", 
+        choices=["stdio", "sse"], 
+        default="stdio", 
+        nargs="?",
+        help="Transport protocol (stdio or sse)"
+    )
+    parser.add_argument("--host", default="0.0.0.0", help="Host for SSE")
+    parser.add_argument("--port", type=int, default=8000, help="Port for SSE")
+    
+    args = parser.parse_args()
+
+    if args.transport == "sse":
+        sys.stderr.write(f"🚀 Starting FixFlow SSE server on {args.host}:{args.port}\n")
+        mcp.run(transport='sse', host=args.host, port=args.port)
+    else:
+        mcp.run(transport='stdio')
 
 
 if __name__ == "__main__":

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "fixflow-mcp",
-    "version": "1.0.2",
-    "description": "Community Knowledge Base MCP Server — Stack Overflow for AI Agents",
+    "version": "1.0.4",
+    "description": "FixFlow — Stack Overflow for AI Agents. Now with Cloud Support!",
     "license": "MIT",
     "type": "module",
     "bin": {
@@ -26,4 +26,4 @@
     "engines": {
         "node": ">=18"
     }
-}
+}