connect-mcp 0.1.0 → 0.1.1

package/Plugin_generator/Generated_Plugins/cowork_plugin/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "generated-mcp",
+  "description": "Loan management plugin via MCP \u2014 approve, create, and retrieve loans",
+  "version": "1.0.0",
+  "author": {
+    "name": "Your Name"
+  }
+}

package/Plugin_generator/Generated_Plugins/cowork_plugin/.mcp.json

@@ -0,0 +1,9 @@
+{
+  "servers": [
+    {
+      "name": "generated-mcp",
+      "url": "https://nondiseased-ciliately-lovetta.ngrok-free.dev/sse",
+      "transport": "sse"
+    }
+  ]
+}

package/Plugin_generator/Generated_Plugins/cowork_plugin/README.md

@@ -0,0 +1,60 @@
+# Loan MCP Plugin
+
+## Overview
+
+This plugin enables Claude to interact with a loan system using MCP tools.
+
+---
+
+## Capabilities
+
+- Create Loan
+- Get Loan
+- Approve Loan
+
+
+---
+
+## Available Tools
+- **create_loan**: Create a new loan for a borrower with a specified amount
+- **get_loan**: Fetch loan details using the loan ID
+- **approve_loan**: Approve an existing loan by loan ID
+
+
+---
+
+## Architecture
+
+Claude (CoWork)
+        |
+        v
+Claude Plugin
+        |
+        v
+MCP Server (SSE)
+        |
+        v
+Backend System
+
+---
+
+## How It Works
+
+- Claude reads skills from the `skills/` directory
+- Each skill maps to an MCP tool
+- The MCP server executes tool calls
+- Results are returned to Claude
+
+---
+
+## Notes
+
+- MCP server must be running and accessible
+- Uses SSE transport
+- Plugin generated automatically from MCP server
+
+---
+
+## Author
+
+Your Name

package/Plugin_generator/Generated_Plugins/cowork_plugin/skills/approve_loan/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: approve_loan
+---
+
+name: approve_loan
+description: Approve an existing loan by loan ID
+---
+
+When using the approve_loan tool:
+
+1. Understand the user's request related to approve_loan
+2. Confirm any required details before calling the tool
+3. Use the `approve_loan` MCP tool to perform the operation
+4. Return the result clearly to the user

package/Plugin_generator/Generated_Plugins/cowork_plugin/skills/create_loan/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: create_loan
+---
+
+name: create_loan
+description: Create a new loan for a borrower with a specified amount
+---
+
+When using the create_loan tool:
+
+1. Understand the user's request related to create_loan
+2. Confirm any required details before calling the tool
+3. Use the `create_loan` MCP tool to perform the operation
+4. Return the result clearly to the user

package/Plugin_generator/Generated_Plugins/cowork_plugin/skills/get_loan/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: get_loan
+---
+
+name: get_loan
+description: Fetch loan details using the loan ID
+---
+
+When using the get_loan tool:
+
+1. Understand the user's request related to get_loan
+2. Confirm any required details before calling the tool
+3. Use the `get_loan` MCP tool to perform the operation
+4. Return the result clearly to the user

package/Plugin_generator/Generated_Plugins/temp_plugin/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "temp-mcp",
+  "description": "tempory plugin for testing mcp",
+  "version": "1.0.0",
+  "author": {
+    "name": "Your Name"
+  }
+}

package/Plugin_generator/Generated_Plugins/temp_plugin/.mcp.json

@@ -0,0 +1,9 @@
+{
+  "servers": [
+    {
+      "name": "temp-mcp",
+      "url": "https://nondiseased-ciliately-lovetta.ngrok-free.dev/sse",
+      "transport": "sse"
+    }
+  ]
+}

package/Plugin_generator/Generated_Plugins/temp_plugin/README.md

@@ -0,0 +1,60 @@
+# Loan MCP Plugin
+
+## Overview
+
+This plugin enables Claude to interact with a loan system using MCP tools.
+
+---
+
+## Capabilities
+
+- Create Loan
+- Approve Loan
+- Delete Loan
+
+
+---
+
+## Available Tools
+- **create_loan**: Create a loan for a borrower
+- **approve_loan**: Approve a loan for a borrower
+- **delete_loan**: Delete a loan for a borrower
+
+
+---
+
+## Architecture
+
+Claude (CoWork)
+        |
+        v
+Claude Plugin
+        |
+        v
+MCP Server (SSE)
+        |
+        v
+Backend System
+
+---
+
+## How It Works
+
+- Claude reads skills from the `skills/` directory
+- Each skill maps to an MCP tool
+- The MCP server executes tool calls
+- Results are returned to Claude
+
+---
+
+## Notes
+
+- MCP server must be running and accessible
+- Uses SSE transport
+- Plugin generated automatically from MCP server
+
+---
+
+## Author
+
+Your Name

package/Plugin_generator/Generated_Plugins/temp_plugin/skills/approve_loan/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: approve_loan
+---
+
+name: approve_loan
+description: Approve a loan for a borrower
+---
+
+When using the approve_loan tool:
+
+1. Understand the user's request related to approve_loan
+2. Confirm any required details before calling the tool
+3. Use the `approve_loan` MCP tool to perform the operation
+4. Return the result clearly to the user

package/Plugin_generator/Generated_Plugins/temp_plugin/skills/create_loan/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: create_loan
+---
+
+name: create_loan
+description: Create a loan for a borrower
+---
+
+When using the create_loan tool:
+
+1. Understand the user's request related to create_loan
+2. Confirm any required details before calling the tool
+3. Use the `create_loan` MCP tool to perform the operation
+4. Return the result clearly to the user

package/Plugin_generator/Generated_Plugins/temp_plugin/skills/delete_loan/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: delete_loan
+---
+
+name: delete_loan
+description: Delete a loan for a borrower
+---
+
+When using the delete_loan tool:
+
+1. Understand the user's request related to delete_loan
+2. Confirm any required details before calling the tool
+3. Use the `delete_loan` MCP tool to perform the operation
+4. Return the result clearly to the user

package/Plugin_generator/config.py

@@ -0,0 +1,9 @@
+MCP_SERVER_URL = "https://nondiseased-ciliately-lovetta.ngrok-free.dev/sse"
+
+OUTPUT_DIR = r"Generated_Plugins\temp_plugin"
+
+PLUGIN_NAME = "temp-mcp"
+
+PLUGIN_DESCRIPTION = "tempory plugin for testing mcp"
+
+AUTHOR_NAME = "Your Name"

package/Plugin_generator/generators/claude/mcp_config.py

@@ -0,0 +1,18 @@
+import os
+from utils.file_utils import write_json
+from config import MCP_SERVER_URL, PLUGIN_NAME
+
+
+def create_mcp_config(plugin_root):
+
+    config = {
+        "servers": [
+            {
+                "name": PLUGIN_NAME,
+                "url": MCP_SERVER_URL,
+                "transport": "sse"
+            }
+        ]
+    }
+
+    write_json(os.path.join(plugin_root, ".mcp.json"), config)

package/Plugin_generator/generators/claude/plugin.py

@@ -0,0 +1,21 @@
+import os
+from utils.file_utils import ensure_dir, write_json
+from config import PLUGIN_NAME, PLUGIN_DESCRIPTION, AUTHOR_NAME
+
+
+def create_plugin_json(plugin_root):
+
+    plugin_dir = os.path.join(plugin_root, ".claude-plugin")
+
+    ensure_dir(plugin_dir)
+
+    plugin_json = {
+        "name": PLUGIN_NAME,
+        "description": PLUGIN_DESCRIPTION,
+        "version": "1.0.0",
+        "author": {
+            "name": AUTHOR_NAME
+        }
+    }
+
+    write_json(os.path.join(plugin_dir, "plugin.json"), plugin_json)

package/Plugin_generator/generators/claude/readme.py

@@ -0,0 +1,91 @@
+import os
+from utils.file_utils import write_file
+from config import AUTHOR_NAME
+
+
+def create_readme(plugin_root, tools):
+
+    readme_path = os.path.join(plugin_root, "README.md")
+
+    capabilities = ""
+    for tool in tools:
+        readable_name = tool["name"].replace("_", " ").title()
+        capabilities += f"- {readable_name}\n"
+
+    words = []
+    for tool in tools:
+        words.extend(tool["name"].split("_"))
+
+    common_words = {}
+    for w in words:
+        common_words[w] = common_words.get(w, 0) + 1
+
+    sorted_words = sorted(common_words.items(), key=lambda x: -x[1])
+
+    domain_word = sorted_words[0][0] if sorted_words else "MCP"
+    domain_title = domain_word.capitalize()
+
+    overview = f"This plugin enables Claude to interact with a {domain_title.lower()} system using MCP tools."
+
+    content = f"""# {domain_title} MCP Plugin
+
+## Overview
+
+{overview}
+
+---
+
+## Capabilities
+
+{capabilities}
+
+---
+
+## Available Tools
+"""
+
+    for tool in tools:
+        content += f"- **{tool['name']}**: {tool.get('description', '')}\n"
+
+    content += f"""
+
+---
+
+## Architecture
+
+Claude (CoWork)
+        |
+        v
+Claude Plugin
+        |
+        v
+MCP Server (SSE)
+        |
+        v
+Backend System
+
+---
+
+## How It Works
+
+- Claude reads skills from the `skills/` directory
+- Each skill maps to an MCP tool
+- The MCP server executes tool calls
+- Results are returned to Claude
+
+---
+
+## Notes
+
+- MCP server must be running and accessible
+- Uses SSE transport
+- Plugin generated automatically from MCP server
+
+---
+
+## Author
+
+{AUTHOR_NAME}
+"""
+
+    write_file(readme_path, content)

package/Plugin_generator/generators/claude/skills.py

@@ -0,0 +1,42 @@
+import os
+from utils.file_utils import ensure_dir, write_file
+
+
+def create_skill(tool, skills_dir):
+
+    tool_name = tool["name"]
+    description = tool.get("description", "No description provided.")
+
+    skill_folder = os.path.join(skills_dir, tool_name)
+
+    ensure_dir(skill_folder)
+
+    skill_path = os.path.join(skill_folder, "SKILL.md")
+
+    content = f"""---
+name: {tool_name}
+---
+
+name: {tool_name}
+description: {description}
+---
+
+When using the {tool_name} tool:
+
+1. Understand the user's request related to {tool_name}
+2. Confirm any required details before calling the tool
+3. Use the `{tool_name}` MCP tool to perform the operation
+4. Return the result clearly to the user
+"""
+
+    write_file(skill_path, content)
+
+
+def generate_skills(tools, plugin_root):
+
+    skills_dir = os.path.join(plugin_root, "skills")
+
+    ensure_dir(skills_dir)
+
+    for tool in tools:
+        create_skill(tool, skills_dir)

package/Plugin_generator/main.py

@@ -0,0 +1,101 @@
+import asyncio
+import os
+import sys
+import traceback
+import argparse
+
+# Fix import path
+sys.path.append(os.path.dirname(os.path.abspath(__file__)))
+
+from mcp.client.sse import sse_client
+from mcp.client.session import ClientSession
+
+from mcp_local.discovery import discover_tools
+
+from generators.claude.plugin import create_plugin_json
+from generators.claude.skills import generate_skills
+from generators.claude.readme import create_readme
+from generators.claude.mcp_config import create_mcp_config
+
+
+# ---------------------------
+# CLI ARGUMENT PARSER
+# ---------------------------
+def parse_args():
+    parser = argparse.ArgumentParser(description="MCP Plugin Generator")
+
+    parser.add_argument(
+        "--url",
+        type=str,
+        required=True,
+        help="MCP server URL (must include /mcp)"
+    )
+
+    parser.add_argument(
+        "--type",
+        type=str,
+        default="cowork",
+        choices=["cowork", "code"],
+        help="Plugin type"
+    )
+
+    return parser.parse_args()
+
+
+# ---------------------------
+# MAIN LOGIC
+# ---------------------------
+async def run_generator(url, plugin_type):
+
+    print(f"\n Starting MCP Plugin Generation ({plugin_type})")
+    print(f" URL: {url}\n")
+
+    # ✅ Dynamic output folder
+    base_output = os.path.join(os.getcwd(), "Generated_Plugins")
+    output_dir = os.path.join(base_output, f"{plugin_type}_plugin")
+
+    try:
+        print(" Discovering MCP tools...")
+
+        async with sse_client(
+            url,
+            headers={"ngrok-skip-browser-warning": "true"}
+        ) as streams:
+
+            async with ClientSession(*streams) as session:
+
+                # Initialize session
+                await session.initialize()
+
+                # Discover tools
+                tools = await discover_tools(session)
+
+                print(f" Found {len(tools)} tools")
+
+                # Ensure output directory
+                os.makedirs(output_dir, exist_ok=True)
+
+                # Generate files
+                create_plugin_json(output_dir)
+                create_mcp_config(output_dir)
+                create_readme(output_dir, tools)
+                generate_skills(tools, output_dir)
+
+                print("\n Plugin generated successfully!")
+                print(f" Location: {output_dir}")
+
+    except Exception as e:
+        print("\n Error occurred:")
+        traceback.print_exc()
+
+
+# ---------------------------
+# ENTRY POINT
+# ---------------------------
+if __name__ == "__main__":
+    args = parse_args()
+
+    if not args.url.endswith("/mcp"):
+        print(" Warning: URL should end with /mcp")
+
+    asyncio.run(run_generator(args.url, args.type))

package/Plugin_generator/mcp_local/client.py

@@ -0,0 +1,11 @@
+from mcp.client.sse import sse_client
+from mcp.client.session import ClientSession
+
+
+async def create_session(mcp_url):
+    streams = await sse_client(mcp_url).__aenter__()
+    session = await ClientSession(*streams).__aenter__()
+
+    await session.initialize()
+
+    return session, streams

package/Plugin_generator/mcp_local/discovery.py

@@ -0,0 +1,14 @@
+async def discover_tools(session):
+
+    tools_response = await session.list_tools()
+
+    tools = []
+
+    for tool in tools_response.tools:
+        tools.append({
+            "name": tool.name,
+            "description": tool.description,
+            "parameters": tool.inputSchema
+        })
+
+    return tools

package/Plugin_generator/requirements.txt

@@ -0,0 +1,4 @@
+mcp
+anyio
+httpx
+sse-starlette

package/Plugin_generator/utils/file_utils.py

@@ -0,0 +1,16 @@
+import os
+import json
+
+
+def ensure_dir(path):
+    os.makedirs(path, exist_ok=True)
+
+
+def write_json(path, data):
+    with open(path, "w") as f:
+        json.dump(data, f, indent=2)
+
+
+def write_file(path, content):
+    with open(path, "w", encoding="utf-8") as f:
+        f.write(content)