Skillz MCP Server

from fastapi import FastAPI, HTTPException import os import frontmatter from pathlib import Path from fastapi.responses import RedirectResponse app = FastAPI() SKILL_INSTRUCTION_MESSAGE = """Skills are designed to teach the local LLM how to perform actions itself, rather than describing a remote service. The information returned is intended to help the LLM understand how to utilize the responses from the MCP server to implement the skill's logic. To effectively use skills: 1. **Install Dependencies**: Ensure all necessary Python dependencies are installed by running `pip install -r requirements.txt` in your environment. 2. **Copy to `tmp`**: For execution, copy relevant skill scripts (e.g., `script.py`) from the skill's directory to your local `tmp` directory. This allows for temporary modifications or executions without affecting original skill files. 3. **Execute from `tmp`**: Run the script from the `tmp` directory, providing any required arguments. For example: `python tmp/your_script.py "arg1" "arg2"`. Agents should utilize the `tmp` directory for any local file generation or copying required during this process.""" @app.get("/") def read_root(): return RedirectResponse(url="/docs") @app.get("/skills") def list_skills(): skills_dir = Path(os.getenv("SKILLZ_DIR", "/skillz")) if not skills_dir.is_dir(): return {"instruction": SKILL_INSTRUCTION_MESSAGE, "error": "skillz directory not found"} skills = [] for skill_dir in skills_dir.iterdir(): if skill_dir.is_dir(): skill_file_path = skill_dir / "SKILL.md" if skill_file_path.is_file(): try: post = frontmatter.load(skill_file_path) skills.append({ "name": post.get("name"), "description": post.get("description"), "skill_id": skill_dir.name }) except Exception as e: # Ignore files that don't have valid frontmatter pass return {"instruction": SKILL_INSTRUCTION_MESSAGE, "skills": skills} @app.get("/skills/{skill_id}") def get_skill(skill_id: str): skill_dir = Path(os.getenv("SKILLZ_DIR", "/skillz")) / skill_id if not skill_dir.is_dir(): raise HTTPException(status_code=404, detail="Skill not found") skill_file_path = skill_dir / "SKILL.md" if not skill_file_path.is_file(): raise HTTPException(status_code=404, detail="SKILL.md not found") with open(skill_file_path, "r") as f: post = frontmatter.load(f) files = [] for dirpath, _, filenames in os.walk(skill_dir): for filename in filenames: relative_path = Path(dirpath).relative_to(skill_dir) / filename files.append(str(relative_path)) return {"instruction": SKILL_INSTRUCTION_MESSAGE, "content": post.content, "metadata": post.metadata, "files": files} @app.get("/skills/{skill_id}/files") def list_skill_files(skill_id: str): skill_dir = Path(os.getenv("SKILLZ_DIR", "/skillz")) / skill_id if not skill_dir.is_dir(): raise HTTPException(status_code=404, detail="Skill not found") files = [] for dirpath, _, filenames in os.walk(skill_dir): for filename in filenames: relative_path = Path(dirpath).relative_to(skill_dir) / filename files.append(str(relative_path)) return {"instruction": SKILL_INSTRUCTION_MESSAGE, "files": files} @app.get("/skills/{skill_id}/{file_path:path}") def get_skill_file(skill_id: str, file_path: str): skill_dir = Path(os.getenv("SKILLZ_DIR", "/skillz")) / skill_id if not skill_dir.is_dir(): raise HTTPException(status_code=404, detail="Skill not found") file = skill_dir / file_path if not file.is_file(): raise HTTPException(status_code=404, detail="File not found") with open(file, "r") as f: post = frontmatter.load(f) return {"instruction": SKILL_INSTRUCTION_MESSAGE, "content": post.content, "metadata": post.metadata}