agent-workflow-mcp-server 0.1.0__tar.gz

agent_workflow_mcp_server-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.pyc
+.venv/
+*.egg-info/
+dist/
+build/
+.env
+*.db

agent_workflow_mcp_server-0.1.0/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: agent-workflow-mcp-server
+Version: 0.1.0
+Summary: Reusable workflow templates for AI agents — share, discover and execute multi-step agent workflows
+Project-URL: Homepage, https://github.com/AiAgentKarl/agent-workflow-mcp-server
+Project-URL: Repository, https://github.com/AiAgentKarl/agent-workflow-mcp-server
+Author: AiAgentKarl
+License: MIT
+Keywords: ai-agents,automation,mcp,orchestration,templates,workflow
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Description-Content-Type: text/markdown
+
+# Agent Workflow MCP Server 🔄
+
+Reusable workflow templates for AI agents. Like recipes for agent tasks — create, share, discover and execute multi-step workflows.
+
+## Features
+
+- **Create Workflows** — Define step-by-step templates for common tasks
+- **Share & Discover** — Search for workflows by category or keyword
+- **Ratings** — Community-driven quality signals
+- **Required Tools** — Each workflow lists which MCP tools are needed
+- **Usage Tracking** — See which workflows are most popular
+
+## Installation
+
+```bash
+pip install agent-workflow-mcp-server
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `create_workflow` | Create a reusable workflow template |
+| `get_workflow` | Get and execute a workflow |
+| `search_workflows` | Search by keyword/category |
+| `rate_workflow` | Rate a workflow (1-5) |
+| `popular_workflows` | Most used workflows |
+| `workflow_categories` | List categories |
+
+## License
+
+MIT

agent_workflow_mcp_server-0.1.0/README.md

@@ -0,0 +1,32 @@
+# Agent Workflow MCP Server 🔄
+
+Reusable workflow templates for AI agents. Like recipes for agent tasks — create, share, discover and execute multi-step workflows.
+
+## Features
+
+- **Create Workflows** — Define step-by-step templates for common tasks
+- **Share & Discover** — Search for workflows by category or keyword
+- **Ratings** — Community-driven quality signals
+- **Required Tools** — Each workflow lists which MCP tools are needed
+- **Usage Tracking** — See which workflows are most popular
+
+## Installation
+
+```bash
+pip install agent-workflow-mcp-server
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `create_workflow` | Create a reusable workflow template |
+| `get_workflow` | Get and execute a workflow |
+| `search_workflows` | Search by keyword/category |
+| `rate_workflow` | Rate a workflow (1-5) |
+| `popular_workflows` | Most used workflows |
+| `workflow_categories` | List categories |
+
+## License
+
+MIT

agent_workflow_mcp_server-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agent-workflow-mcp-server"
+version = "0.1.0"
+description = "Reusable workflow templates for AI agents — share, discover and execute multi-step agent workflows"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+authors = [{name = "AiAgentKarl"}]
+keywords = ["mcp", "workflow", "templates", "ai-agents", "automation", "orchestration"]
+dependencies = ["mcp>=1.0.0", "pydantic>=2.0.0"]
+
+[project.urls]
+Homepage = "https://github.com/AiAgentKarl/agent-workflow-mcp-server"
+Repository = "https://github.com/AiAgentKarl/agent-workflow-mcp-server"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src"]

agent_workflow_mcp_server-0.1.0/src/db.py

@@ -0,0 +1,146 @@
+"""Datenbank — SQLite-basierte Workflow-Template-Verwaltung."""
+
+import sqlite3
+import json
+import os
+from datetime import datetime, timezone
+from pathlib import Path
+
+_DB_PATH = os.getenv("WORKFLOW_DB_PATH", str(Path(__file__).resolve().parent.parent / "workflows.db"))
+
+
+def _connect() -> sqlite3.Connection:
+    conn = sqlite3.connect(_DB_PATH)
+    conn.row_factory = sqlite3.Row
+    conn.execute("PRAGMA journal_mode=WAL")
+    conn.execute("""
+        CREATE TABLE IF NOT EXISTS workflows (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            name TEXT UNIQUE NOT NULL,
+            description TEXT NOT NULL,
+            category TEXT NOT NULL,
+            steps TEXT NOT NULL,
+            required_tools TEXT,
+            input_schema TEXT,
+            output_schema TEXT,
+            author TEXT,
+            tags TEXT,
+            uses INTEGER DEFAULT 0,
+            avg_rating REAL DEFAULT 0,
+            total_ratings INTEGER DEFAULT 0,
+            created_at TEXT NOT NULL,
+            updated_at TEXT NOT NULL
+        )
+    """)
+    conn.execute("""
+        CREATE TABLE IF NOT EXISTS workflow_ratings (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            workflow_name TEXT NOT NULL,
+            rating INTEGER NOT NULL CHECK(rating BETWEEN 1 AND 5),
+            review TEXT,
+            created_at TEXT NOT NULL
+        )
+    """)
+    conn.commit()
+    return conn
+
+
+def create_workflow(
+    name: str, description: str, category: str, steps: list[dict],
+    required_tools: list[str] = None, input_schema: dict = None,
+    output_schema: dict = None, author: str = None, tags: list[str] = None,
+) -> dict:
+    conn = _connect()
+    now = datetime.now(timezone.utc).isoformat()
+    conn.execute(
+        """INSERT INTO workflows (name, description, category, steps,
+           required_tools, input_schema, output_schema, author, tags,
+           created_at, updated_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+           ON CONFLICT(name) DO UPDATE SET
+               description=excluded.description, steps=excluded.steps,
+               required_tools=excluded.required_tools, updated_at=excluded.updated_at""",
+        (name, description, category, json.dumps(steps),
+         json.dumps(required_tools) if required_tools else None,
+         json.dumps(input_schema) if input_schema else None,
+         json.dumps(output_schema) if output_schema else None,
+         author, json.dumps(tags) if tags else None, now, now),
+    )
+    conn.commit()
+    conn.close()
+    return {"name": name, "created": True}
+
+
+def get_workflow(name: str) -> dict | None:
+    conn = _connect()
+    conn.execute("UPDATE workflows SET uses = uses + 1 WHERE name=?", (name,))
+    conn.commit()
+    row = conn.execute("SELECT * FROM workflows WHERE name=?", (name,)).fetchone()
+    conn.close()
+    if not row:
+        return None
+    d = dict(row)
+    for field in ["steps", "required_tools", "input_schema", "output_schema", "tags"]:
+        d[field] = json.loads(d[field]) if d[field] else None
+    return d
+
+
+def search_workflows(query: str = None, category: str = None, limit: int = 20) -> list:
+    conn = _connect()
+    sql = "SELECT * FROM workflows WHERE 1=1"
+    params = []
+    if query:
+        sql += " AND (name LIKE ? OR description LIKE ? OR tags LIKE ?)"
+        params.extend([f"%{query}%"] * 3)
+    if category:
+        sql += " AND category=?"
+        params.append(category)
+    sql += " ORDER BY uses DESC LIMIT ?"
+    params.append(limit)
+    rows = conn.execute(sql, params).fetchall()
+    conn.close()
+    results = []
+    for r in rows:
+        d = dict(r)
+        for field in ["steps", "required_tools", "tags"]:
+            d[field] = json.loads(d[field]) if d[field] else None
+        results.append(d)
+    return results
+
+
+def rate_workflow(name: str, rating: int, review: str = None) -> dict:
+    conn = _connect()
+    now = datetime.now(timezone.utc).isoformat()
+    conn.execute(
+        "INSERT INTO workflow_ratings (workflow_name, rating, review, created_at) VALUES (?, ?, ?, ?)",
+        (name, rating, review, now),
+    )
+    avg = conn.execute(
+        "SELECT AVG(rating) as a, COUNT(*) as c FROM workflow_ratings WHERE workflow_name=?", (name,)
+    ).fetchone()
+    conn.execute(
+        "UPDATE workflows SET avg_rating=?, total_ratings=? WHERE name=?",
+        (round(avg["a"], 2), avg["c"], name),
+    )
+    conn.commit()
+    conn.close()
+    return {"workflow": name, "rating": rating, "new_avg": round(avg["a"], 2)}
+
+
+def list_categories() -> list:
+    conn = _connect()
+    rows = conn.execute(
+        "SELECT category, COUNT(*) as count FROM workflows GROUP BY category ORDER BY count DESC"
+    ).fetchall()
+    conn.close()
+    return [dict(r) for r in rows]
+
+
+def get_popular(limit: int = 10) -> list:
+    conn = _connect()
+    rows = conn.execute(
+        "SELECT name, category, description, uses, avg_rating FROM workflows ORDER BY uses DESC LIMIT ?",
+        (limit,),
+    ).fetchall()
+    conn.close()
+    return [dict(r) for r in rows]

agent_workflow_mcp_server-0.1.0/src/server.py

@@ -0,0 +1,16 @@
+"""Agent Workflow MCP Server — Wiederverwendbare Workflows für AI-Agents."""
+
+from mcp.server.fastmcp import FastMCP
+from src.tools.workflows import register_workflow_tools
+
+mcp = FastMCP(
+    "Agent Workflows",
+    instructions="Reusable workflow templates for AI agents. Create, share, discover and rate multi-step workflows. Like recipes for agent tasks.",
+)
+register_workflow_tools(mcp)
+
+def main():
+    mcp.run(transport="stdio")
+
+if __name__ == "__main__":
+    main()

agent_workflow_mcp_server-0.1.0/src/tools/workflows.py

@@ -0,0 +1,74 @@
+"""Workflow-Tools — Wiederverwendbare Arbeitsabläufe für AI-Agents."""
+
+from mcp.server.fastmcp import FastMCP
+from src import db
+
+
+def register_workflow_tools(mcp: FastMCP):
+
+    @mcp.tool()
+    async def create_workflow(
+        name: str, description: str, category: str, steps: list[dict],
+        required_tools: list[str] = None, author: str = None, tags: list[str] = None,
+    ) -> dict:
+        """Einen Workflow-Template erstellen und teilen.
+
+        Args:
+            name: Eindeutiger Workflow-Name
+            description: Was der Workflow macht
+            category: Kategorie (z.B. "research", "analysis", "due-diligence")
+            steps: Liste von Schritten [{\"step\": 1, \"action\": \"...\", \"tool\": \"...\"}]
+            required_tools: Welche MCP-Tools werden benötigt
+            author: Autor des Workflows
+            tags: Tags für bessere Auffindbarkeit
+        """
+        return db.create_workflow(name, description, category, steps, required_tools, author=author, tags=tags)
+
+    @mcp.tool()
+    async def get_workflow(name: str) -> dict:
+        """Einen Workflow-Template abrufen und ausführen.
+
+        Args:
+            name: Name des Workflows
+        """
+        result = db.get_workflow(name)
+        if result:
+            return result
+        return {"found": False, "name": name}
+
+    @mcp.tool()
+    async def search_workflows(query: str = None, category: str = None, limit: int = 10) -> dict:
+        """Workflows suchen.
+
+        Args:
+            query: Suchbegriff
+            category: Kategorie-Filter
+            limit: Maximale Ergebnisse
+        """
+        results = db.search_workflows(query, category, limit)
+        return {"results_count": len(results), "workflows": results}
+
+    @mcp.tool()
+    async def rate_workflow(name: str, rating: int, review: str = None) -> dict:
+        """Workflow bewerten (1-5 Sterne).
+
+        Args:
+            name: Workflow-Name
+            rating: 1-5 Sterne
+            review: Optionaler Text
+        """
+        return db.rate_workflow(name, rating, review)
+
+    @mcp.tool()
+    async def popular_workflows(limit: int = 10) -> dict:
+        """Beliebteste Workflows anzeigen.
+
+        Args:
+            limit: Anzahl
+        """
+        return {"popular": db.get_popular(limit)}
+
+    @mcp.tool()
+    async def workflow_categories() -> dict:
+        """Alle Workflow-Kategorien auflisten."""
+        return {"categories": db.list_categories()}