mirror of
https://github.com/PrefectHQ/fastmcp.git
synced 2026-08-18 19:44:19 +02:00
7d76c9d055* Add examples/ to ty static-analysis gate * Fix example type errors and stale SDK idioms for ty * Use typing_extensions.TypedDict for the quiz tool-param type Question is a take_quiz parameter, so FastMCP builds a Pydantic schema for it; typing.TypedDict raises PydanticUserError on Python 3.10/3.11 (only 3.12+ accepts it). ty and 3.12 runs miss this, so it slipped in. * Guard get_access_token() None case in huggingface_oauth example Caught by the ty gate this PR adds: the example, merged separately, had never been type-checked against examples/. Matches the existing aws_oauth/keycloak_oauth pattern. * Print actual YAML text in custom serializer example
66 lines
2.1 KiB
Python
66 lines
2.1 KiB
Python
"""Example: Skills Client
|
|
|
|
This example shows how to discover and download skills from a skills server.
|
|
|
|
Run this client (it starts its own server internally):
|
|
uv run python examples/skills/client.py
|
|
"""
|
|
|
|
import asyncio
|
|
import json
|
|
from pathlib import Path
|
|
|
|
from fastmcp import Client
|
|
from fastmcp.server.providers.skills import SkillsDirectoryProvider
|
|
|
|
|
|
async def main():
|
|
# Create a skills provider pointing at our sample skills
|
|
skills_dir = Path(__file__).parent / "sample_skills"
|
|
provider = SkillsDirectoryProvider(roots=skills_dir)
|
|
|
|
# Connect to a FastMCP server with this provider
|
|
from fastmcp import FastMCP
|
|
|
|
mcp = FastMCP("Skills Server")
|
|
mcp.add_provider(provider)
|
|
|
|
async with Client(mcp) as client:
|
|
print("Connected to skills server\n")
|
|
|
|
# List available resources
|
|
print("=== Available Resources ===")
|
|
resources = await client.list_resources()
|
|
for r in resources:
|
|
print(f" {r.uri}")
|
|
if r.description:
|
|
print(f" Description: {r.description}")
|
|
print()
|
|
|
|
# List resource templates
|
|
print("=== Resource Templates ===")
|
|
templates = await client.list_resource_templates()
|
|
for t in templates:
|
|
print(f" {t.uri_template}")
|
|
print()
|
|
|
|
# Read a skill's main file
|
|
print("=== Reading pdf-processing/SKILL.md ===")
|
|
result = await client.read_resource("skill://pdf-processing/SKILL.md")
|
|
print(result[0].text[:500] + "...\n")
|
|
|
|
# Read the manifest to see all files
|
|
print("=== Reading pdf-processing/_manifest ===")
|
|
result = await client.read_resource("skill://pdf-processing/_manifest")
|
|
manifest = json.loads(result[0].text)
|
|
print(json.dumps(manifest, indent=2))
|
|
print()
|
|
|
|
# Read a supporting file via template
|
|
print("=== Reading pdf-processing/reference.md ===")
|
|
result = await client.read_resource("skill://pdf-processing/reference.md")
|
|
print(result[0].text[:500] + "...\n")
|
|
|
|
|
|
if __name__ == "__main__":
|
|
asyncio.run(main())
|