
FastMCP å ¥é (4) - ãªãœãŒã¹
ãFastMCPãã®ããªãœãŒã¹ãã«ã€ããŠãŸãšããŸããã
åå
1. ãªãœãŒã¹
ããªãœãŒã¹ãã¯MCPã¯ã©ã€ã¢ã³ããèªã¿åããããŒã¿ãŸãã¯ãã¡ã€ã«ã衚ããŸããããªãœãŒã¹ãã³ãã¬ãŒããã¯ãã®æŠå¿µãæ¡åŒµããã¯ã©ã€ã¢ã³ããURIã§æž¡ããããã©ã¡ãŒã¿ã«åºã¥ããŠåçã«çæããããªãœãŒã¹ããªã¯ãšã¹ãã§ããããã«ããŸãã
FastMCPã¯ãäž»ã«@mcp.resourceãã³ã¬ãŒã¿ã䜿çšããŠãéçãªãœãŒã¹ãšåçãªãœãŒã¹ã®äž¡æ¹ã®å®çŸ©ãç°¡çŽ åããŸãã
ã»FastMCPã¯å¯Ÿå¿ãããªãœãŒã¹å®çŸ©ãæ€çŽ¢ããŸãã
ã»ãªãœãŒã¹ãåçãªå Žå (颿°ã«ãã£ãŠå®çŸ©ãããŠããå Žå)ããã®é¢æ°ãå®è¡ãããŸãã
ã»ã³ã³ãã³ã (ããã¹ããJSONããã€ããªããŒã¿) ãã¯ã©ã€ã¢ã³ãã«è¿ãããŸãã
ããã«ãããLLMã¯ãã¡ã€ã«ãããŒã¿ããŒã¹ã³ã³ãã³ããæ§æãäŒè©±ã«é¢é£ããåççæãããæ å ±ã«ã¢ã¯ã»ã¹ã§ããŸãã
2. @mcp.resourceãã³ã¬ãŒã¿
ãªãœãŒã¹ãå®çŸ©ããæãäžè¬çãªæ¹æ³ã¯ãPython颿°ããã³ã¬ãŒãããããšã§ãããã³ã¬ãŒã¿ã«ã¯ããªãœãŒã¹ã®äžæã®URIãå¿ èŠã§ãã
import json
from fastmcp import FastMCP
mcp = FastMCP(name="DataServer")
# æååãè¿ãåºæ¬çãªåçãªãœãŒã¹
@mcp.resource("resource://greeting")
def get_greeting() -> str:
"""ç°¡åãªæšæ¶ã¡ãã»ãŒãžãæäŸ"""
return "FastMCP Resources ããããã«ã¡ã¯!"
# JSON ããŒã¿ãè¿ããªãœãŒã¹ (dict ã¯èªåã·ãªã¢ã©ã€ãº)
@mcp.resource("data://config")
def get_config() -> dict:
"""ã¢ããªã±ãŒã·ã§ã³æ§æã JSONãšããŠæäŸ"""
return {
"theme": "dark",
"version": "1.2.0",
"features": ["tools", "resources"],
}ã»URI
@resource ã®æåã®åŒæ°ã¯ãã¯ã©ã€ã¢ã³ãããã®ããŒã¿ããªã¯ãšã¹ãããããã«äœ¿çšããäžæã® URI (äŸ: "resource://greeting") ã§ãã
ã»é å»¶èªã¿èŸŒã¿
ãã³ã¬ãŒãããã颿° (get_greetingãget_config) ã¯ãã¯ã©ã€ã¢ã³ãã resources/read çµç±ã§ãã®ãªãœãŒã¹ URI ãæç€ºçã«ãªã¯ãšã¹ãããå Žåã«ã®ã¿å®è¡ãããŸãã
ã»æšè«ãããã¡ã¿ããŒã¿
ããã©ã«ãã§ã¯ã以äžã®ããã«ãªããŸãã
ãã»ãªãœãŒã¹å : 颿°å (get_greeting) ããååŸãããŸãã
ãã»ãªãœãŒã¹ã®èª¬æ : 颿°ã®ããã¥ã¡ã³ãæååããååŸãããŸãã
3. æ»ãå€
FastMCPã¯ã颿°ã®æ»ãå€ãé©åãªMCPãªãœãŒã¹ã³ã³ãã³ãã«èªåçã«å€æããŸãã
ã»str
TextResourceContents ãšããŠéä¿¡ãããŸã (ããã©ã«ãã§ã¯ mime_type="text/plain")ã
ã»dictãlistãpydantic.BaseModel
èªåçã« JSON æååã«ã·ãªã¢ã«åãããTextResourceContents ãšããŠéä¿¡ãããŸã (ããã©ã«ãã§ã¯ mime_type="application/json")ã
ã»bytes
Base64ãšã³ã³ãŒããããBlobResourceContents ãšããŠéä¿¡ãããŸããé©å㪠mime_type (äŸ: "image/png"ã"application/octet-stream") ãæå®ããŠãã ããã
ã»None
空ã®ãªãœãŒã¹ã³ã³ãã³ããªã¹ããè¿ãããŸãã
4. ãªãœãŒã¹ã®ã¡ã¿ããŒã¿
ãã³ã¬ãŒã¿ã®åŒæ°ã䜿çšããŠããªãœãŒã¹ã®ããããã£ãã«ã¹ã¿ãã€ãºã§ããŸãã
from fastmcp import FastMCP
mcp = FastMCP(name="DataServer")
# ã¡ã¿ããŒã¿ãæå®ããäŸ
@mcp.resource(
uri="data://app-status", # æç€ºçãªURI (å¿
é )
name="ApplicationStatus", # ã«ã¹ã¿ã å
description="ã¢ããªã±ãŒã·ã§ã³ã®çŸåšã®ã¹ããŒã¿ã¹ãæäŸ", # ã«ã¹ã¿ã 説æ
mime_type="application/json", # æç€ºçãªMIMEã¿ã€ã
tags={"monitoring", "status"} # åé¡ã¿ã°
)
def get_application_status() -> dict:
"""å
éšé¢æ°ã®èª¬æ (äžèšã«èª¬æãæäŸãããŠããå Žåã¯ç¡èŠãããŸã)"""
return {"status": "ok", "uptime": 12345, "version": mcp.settings.version} # Example usageã»uri
ãªãœãŒã¹ã®äžæã®èå¥å (å¿ é )
ã»name
人éãèªããåå (ããã©ã«ãã¯é¢æ°å)
ã»description
ãªãœãŒã¹ã®èª¬æ (ããã©ã«ãã¯docstring)
ã»mime_type
ã³ã³ãã³ãã¿ã€ããæå®ããŸã (FastMCPã¯text/plainãapplication/jsonãªã©ã®ããã©ã«ããæšæž¬ããããšãå€ãã§ãããããã¹ã以å€ã®ã¿ã€ãã®å Žåã¯æç€ºçã«æå®ããæ¹ãé©åã§ã)
ã»tags
åé¡çšã®æååã®ã»ãããã¯ã©ã€ã¢ã³ãããã£ã«ã¿ãªã³ã°ã«äœ¿çšããå¯èœæ§ããããŸãã
5. MCPã³ã³ããã¹ããžã®ã¢ã¯ã»ã¹
ãªãœãŒã¹ãšãªãœãŒã¹ãã³ãã¬ãŒãã¯ãContextãªããžã§ã¯ããä»ããŠMCPã®è¿œå æ å ±ãšæ©èœã«ã¢ã¯ã»ã¹ã§ããŸããããã«ã¢ã¯ã»ã¹ããã«ã¯ããªãœãŒã¹é¢æ°ã«Contextåã¢ãããŒã·ã§ã³ãä»äžãããã©ã¡ãŒã¿ã远å ããŸãã
from fastmcp import FastMCP, Context
mcp = FastMCP(name="DataServer")
@mcp.resource("resource://system-status")
async def get_system_status(ctx: Context) -> dict:
"""ã·ã¹ãã ã¹ããŒã¿ã¹æ
å ±ãæäŸ"""
return {
"status": "operational",
"request_id": ctx.request_id
}
@mcp.resource("resource://{name}/details")
async def get_details(name: str, ctx: Context) -> dict:
"""ç¹å®ã®ååã®è©³çްãååŸ"""
return {
"name": name,
"accessed_at": ctx.request_id
}詳ããã¯ãContextã®ããã¥ã¡ã³ããåç §ããŠãã ããã
6. éåæãªãœãŒã¹
ãµãŒãã®ãããã¯ãåé¿ãããããI/Oæäœ (ããŒã¿ããŒã¹ããããã¯ãŒã¯ããã®èªã¿åããªã©) ãå®è¡ãããªãœãŒã¹é¢æ°ã«ã¯ async def ã䜿çšããŸãã
import aiofiles
from fastmcp import FastMCP
mcp = FastMCP(name="DataServer")
@mcp.resource("file:///app/data/important_log.txt", mime_type="text/plain")
async def read_important_log() -> str:
"""ç¹å®ã®ãã°ãã¡ã€ã«ããéåæçã«ã³ã³ãã³ããèªã¿åã"""
try:
async with aiofiles.open("/app/data/important_log.txt", mode="r") as f:
content = await f.read()
return content
except FileNotFoundError:
return "ãã°ãã¡ã€ã«ãèŠã€ãããŸããã"7. ãªãœãŒã¹ã¯ã©ã¹
@mcp.resource ã¯åçã³ã³ãã³ãã«æé©ã§ãããmcp.add_resource() ãšå ·äœç㪠Resourceãµãã¯ã©ã¹ã䜿çšããŠãå®çŸ©æžã¿ã®ãªãœãŒã¹ (éçãã¡ã€ã«ãåçŽãªããã¹ããªã©) ãçŽæ¥ç»é²ããããšãã§ããŸãã
from pathlib import Path
from fastmcp import FastMCP
from fastmcp.resources import FileResource, TextResource, DirectoryResource
mcp = FastMCP(name="DataServer")
# 1. éçãã¡ã€ã«ãçŽæ¥å
Ž
readme_path = Path("./README.md").resolve()
if readme_path.exists():
# Use a file:// URI scheme
readme_resource = FileResource(
uri=f"file://{readme_path.as_posix()}",
path=readme_path, # Path to the actual file
name="README File",
description="The project's README.",
mime_type="text/markdown",
tags={"documentation"}
)
mcp.add_resource(readme_resource)
# 2. ã·ã³ãã«ãªå®çŸ©æžã¿ããã¹ããå
Ž
notice_resource = TextResource(
uri="resource://notice",
name="Important Notice",
text="æ¥ææ¥ã«ã·ã¹ãã ã¡ã³ããã³ã¹ãäºå®ãããŠããŸãã",
tags={"notification"}
)
mcp.add_resource(notice_resource)
# 3. URIãšã¯ç°ãªãã«ã¹ã¿ã ããŒã䜿çš
special_resource = TextResource(
uri="resource://common-notice",
name="Special Notice",
text="ããã¯ã«ã¹ã¿ã ã¹ãã¬ãŒãžããŒã«é¢ããç¹å¥ãªéç¥ã§ãã",
)
mcp.add_resource(special_resource, key="resource://custom-key")
# 4. ãã£ã¬ã¯ããªãªã¹ãã®å
Ž
data_dir_path = Path("./app_data").resolve()
if data_dir_path.is_dir():
data_listing_resource = DirectoryResource(
uri="resource://data-files",
path=data_dir_path, # ãã£ã¬ã¯ããªãžã®ãã¹
name="Data Directory Listing",
description="ããŒã¿ãã£ã¬ã¯ããªã§äœ¿çšå¯èœãªãã¡ã€ã«ãäžèŠ§è¡šç€ºããŸãã",
recursive=False # ãµããã£ã¬ã¯ããªãäžèŠ§è¡šç€ºããã«ã¯Trueã«èšå®
)
mcp.add_resource(data_listing_resource) # ãã¡ã€ã«ã®JSONãªã¹ããè¿ãã»TextResource
åçŽãªæååã³ã³ãã³ãçš
ã»BinaryResource
çã®ãã€ãåã³ã³ãã³ãçš
ã»FileResource
ããŒã«ã«ãã¡ã€ã«ãã¹ããã³ã³ãã³ããèªã¿åããŸããããã¹ã/ãã€ããªã¢ãŒããšé å»¶èªã¿åãã«å¯Ÿå¿ããŠããŸãã
ã»HttpResource
HTTP(S) URL ããã³ã³ãã³ããååŸããŸãïŒhttpx ãå¿ èŠã§ãïŒã
ã»DirectoryResource
ããŒã«ã«ãã£ã¬ã¯ããªå ã®ãã¡ã€ã«ãäžèŠ§è¡šç€ºããŸãïŒJSON ãè¿ããŸãïŒã
(FunctionResource: @mcp.resource ã䜿çšããå éšã¯ã©ã¹)ã
ã³ã³ãã³ããéçã§ãããããã¡ã€ã«/URLããçŽæ¥ååŸãããå Žåã«ãããã䜿çšããŠãå°çšã®Python颿°ã®å¿ èŠæ§ãåé¿ããŸãã
8. ã«ã¹ã¿ã ãªãœãŒã¹ããŒ
mcp.add_resource() ã䜿çšããŠãªãœãŒã¹ãçŽæ¥è¿œå ããå Žåã¯ããªãã·ã§ã³ã§ã«ã¹ã¿ã ã¹ãã¬ãŒãžããŒãæå®ã§ããŸãã
# æšæºURIãããŒãšããŠãªãœãŒã¹ãäœæ
resource = TextResource(uri="resource://data")
mcp.add_resource(resource) # "resource://data" ã䜿çšããŠä¿åããã³ã¢ã¯ã»ã¹
# ã«ã¹ã¿ã ããŒã䜿çšããŠãªãœãŒã¹ãäœæãã
special_resource = TextResource(uri="resource://special-data")
mcp.add_resource(special_resource, key="internal://data-v2") # "internal://data-v2"ã䜿çšããŠä¿åããã³ã¢ã¯ã»ã¹ãã®ãã©ã¡ãŒã¿ã¯ããã³ã¬ãŒã¿ã䜿çšãããšãã« URI ãæç€ºçã«æäŸããããããadd_resource() ãçŽæ¥äœ¿çšããå Žåã«ã®ã¿äœ¿çšå¯èœã§ããã@resourceãã³ã¬ãŒã¿çµç±ã¯äœ¿çšã§ããŸããã
9. ãªãœãŒã¹ãã³ãã¬ãŒã
ãªãœãŒã¹ãã³ãã¬ãŒãã䜿çšãããšãã¯ã©ã€ã¢ã³ãã¯URIã«åã蟌ãŸãããã©ã¡ãŒã¿ã«å¿ããŠã³ã³ãã³ããå€åãããªãœãŒã¹ããªã¯ãšã¹ãã§ããŸãããã³ãã¬ãŒãã¯@mcp.resourceãã³ã¬ãŒã¿ã䜿çšããŠå®çŸ©ããŸãããURIæååã«{parameter_name}ãã¬ãŒã¹ãã«ããå«ãã察å¿ããåŒæ°ã颿°ã·ã°ããã£ã«è¿œå ããŸãã
ãªãœãŒã¹ãã³ãã¬ãŒãã¯ãéåžžã®ãªãœãŒã¹ãšã»ãšãã©ã®èšå®ãªãã·ã§ã³ïŒååã説æãMIMEã¿ã€ããã¿ã°ïŒãå ±æããŸããã颿°ãã©ã¡ãŒã¿ã«ãããã³ã°ãããURIãã©ã¡ãŒã¿ãå®çŸ©ããæ©èœã远å ãããŠããŸãã
ãªãœãŒã¹ãã³ãã¬ãŒãã¯ããã©ã¡ãŒã¿ã®äžæã®ã»ããããšã«æ°ãããªãœãŒã¹ãçæããããããªãœãŒã¹ããªã³ããã³ãã§åçã«äœæã§ããŸããäŸãã°ããªãœãŒã¹ãã³ãã¬ãŒããuser://profile/{name}ããç»é²ãããŠããå ŽåãMCPã¯ã©ã€ã¢ã³ãã¯ãuser://profile/fordããŸãã¯ãuser://profile/marvinãããªã¯ãšã¹ãããããšã§ãããã2ã€ã®ãŠãŒã¶ãŒãããã¡ã€ã«ã®ããããããªãœãŒã¹ãšããŠååŸã§ããŸããåãªãœãŒã¹ãåå¥ã«ç»é²ããå¿ èŠã¯ãããŸããã
2ã€ã®ãªãœãŒã¹ãã³ãã¬ãŒããå®çŸ©ããæ¹æ³ã瀺ãå®å šãªäŸã以äžã«ç€ºããŸãã
from fastmcp import FastMCP
mcp = FastMCP(name="DataServer")
# Template URI includes {city} placeholder
@mcp.resource("weather://{city}/current")
def get_weather(city: str) -> dict:
"""ç¹å®ã®éœåžã®å€©æ°æ
å ±ãæäŸ"""
# å®éã®å®è£
ã§ã¯ã倩æ°äºå ±APIãåŒã³åºã
# ããã§ã¯äŸãšããŠç°¡ç¥åããããžãã¯ã䜿çš
return {
"city": city.capitalize(),
"temperature": 22,
"condition": "Sunny",
"unit": "celsius"
}
# è€æ°ã®ãã©ã¡ãŒã¿ãæã€ãã³ãã¬ãŒã
@mcp.resource("repos://{owner}/{repo}/info")
def get_repo_info(owner: str, repo: str) -> dict:
"""GitHub ãªããžããªã«é¢ããæ
å ±ãååŸ"""
# å®éã®å®è£
ã§ã¯ãGitHub APIãåŒã³åºãããšã«ãªãã
return {
"owner": owner,
"name": repo,
"full_name": f"{owner}/{repo}",
"stars": 120,
"forks": 48
}ã»weather://london/current â ãã³ãã³ã®å€©æ°ãè¿ããŸã
ã»weather://paris/current â ããªã®å€©æ°ãè¿ããŸã
ã»repos://jlowin/fastmcp/info â jlowin/fastmcp ãªããžããªã«é¢ããæ å ±ãè¿ããŸã
ã»repos://prefecthq/prefect/info â prefecthq/prefect ãªããžããªã«é¢ããæ å ±ãè¿ããŸã
10. ã¯ã€ã«ãã«ãŒããã©ã¡ãŒã¿
ãªãœãŒã¹ãã³ãã¬ãŒãã¯ãè€æ°ã®ãã¹ã»ã°ã¡ã³ãã«äžèŽããã¯ã€ã«ãã«ãŒããã©ã¡ãŒã¿ããµããŒãããŠããŸããæšæºãã©ã¡ãŒã¿ïŒ{param}ïŒã¯åäžã®ãã¹ã»ã°ã¡ã³ãã«ã®ã¿äžèŽããã/ãå¢çãè¶ããããšã¯ãããŸãããäžæ¹ãã¯ã€ã«ãã«ãŒããã©ã¡ãŒã¿ïŒ{param*}ïŒã¯ãã¹ã©ãã·ã¥ãå«ãè€æ°ã®ã»ã°ã¡ã³ãããã£ããã£ã§ããŸããã¯ã€ã«ãã«ãŒãã¯ãURIãã³ãã¬ãŒãã®å®çŸ©éšåïŒãªãã©ã«ãŸãã¯å¥ã®ãã©ã¡ãŒã¿ïŒãŸã§ã®ãåŸç¶ã®ãã¹ãŠã®ãã¹ã»ã°ã¡ã³ãããã£ããã£ããŸããããã«ãããåäžã®URIãã³ãã¬ãŒãã«è€æ°ã®ã¯ã€ã«ãã«ãŒããã©ã¡ãŒã¿ãå«ããããšãã§ããŸãã
from fastmcp import FastMCP
mcp = FastMCP(name="DataServer")
# æšæºãã©ã¡ãŒã¿ã¯1ã€ã®ã»ã°ã¡ã³ãã®ã¿ã«äžèŽ
@mcp.resource("files://{filename}")
def get_file(filename: str) -> str:
"""ååã§ãã¡ã€ã«ãååŸ"""
# files://<single-segment> ã®ã¿ã«äžèŽ
return f"File content for: {filename}"
# ã¯ã€ã«ãã«ãŒããã©ã¡ãŒã¿ã¯è€æ°ã®ã»ã°ã¡ã³ãã«äžèŽã§ãã
@mcp.resource("path://{filepath*}")
def get_path_content(filepath: str) -> str:
"""ç¹å®ã®ãã¹ã«ããã³ã³ãã³ããååŸ"""
# path://docs/server/resources.mdx ã«äžèŽ
return f"Content at path: {filepath}"
# æšæºãã©ã¡ãŒã¿ãšã¯ã€ã«ãã«ãŒããã©ã¡ãŒã¿ã®æ··åš
@mcp.resource("repo://{owner}/{path*}/template.py")
def get_template_file(owner: str, path: str) -> dict:
"""ç¹å®ã®ãªããžããªãšãã¹ãããã¡ã€ã«ãååŸããŸã
ãã ãããªãœãŒã¹ã `template.py` ã§çµããå Žåã®ã¿"""
# repo://jlowin/fastmcp/src/resources/template.py ã«äžèŽ
return {
"owner": owner,
"path": path + "/template.py",
"content": f"File at {path}/template.py in {owner}'s repository"
}ã¯ã€ã«ãã«ãŒããã©ã¡ãŒã¿ã¯ã次ã®ãããªå Žåã«åœ¹ç«ã¡ãŸãã
ã»ãã¡ã€ã«ãã¹ãŸãã¯éå±€åããŒã¿ãæ±ãå Žå
ã»å¯å€é·ã®ãã¹ã»ã°ã¡ã³ãããã£ããã£ããå¿ èŠããã API ãäœæããå Žå
ã»REST API ã«äŒŒã URL ã®ãããªãã¿ãŒã³ãæ§ç¯ããå Žå
éåžžã®ãã©ã¡ãŒã¿ãšåæ§ã«ãã¯ã€ã«ãã«ãŒããã©ã¡ãŒã¿ã¯é¢æ°ã·ã°ããã£å ã§ååä»ããã©ã¡ãŒã¿ãšããŠæå®ããå¿ èŠããããå¿ èŠãªãã¹ãŠã®é¢æ°ãã©ã¡ãŒã¿ã¯ URI ãã³ãã¬ãŒãã«èšè¿°ããå¿ èŠãããããšã«æ³šæããŠãã ããã
11. ããã©ã«ãå€
ãªãœãŒã¹ãã³ãã¬ãŒããäœæããéãFastMCP 㯠URI ãã³ãã¬ãŒããã©ã¡ãŒã¿ãšé¢æ°ãã©ã¡ãŒã¿ã®é¢ä¿ã«ã€ã㊠2 ã€ã®ã«ãŒã«ãé©çšããŸãã
ã»å¿ é ã®é¢æ°ãã©ã¡ãŒã¿
ããã©ã«ãå€ã®ãªããã¹ãŠã®é¢æ°ãã©ã¡ãŒã¿ (å¿ é ãã©ã¡ãŒã¿) ã¯ãURI ãã³ãã¬ãŒãã«èšè¿°ããå¿ èŠããããŸãã
ã»URI ãã©ã¡ãŒã¿
ãã¹ãŠã® URI ãã³ãã¬ãŒããã©ã¡ãŒã¿ã¯ã颿°ãã©ã¡ãŒã¿ãšããŠååšããå¿ èŠããããŸãã
ãã ããããã©ã«ãå€ãæã€é¢æ°ãã©ã¡ãŒã¿ã¯ãURIãã³ãã¬ãŒãã«å«ããå¿ èŠã¯ãããŸãããã¯ã©ã€ã¢ã³ãããªãœãŒã¹ããªã¯ãšã¹ããããšãFastMCPã¯æ¬¡ã®åŠçãè¡ããŸãã
ã»ãã³ãã¬ãŒãã«å«ãŸãããã©ã¡ãŒã¿ã«ã€ããŠã¯ãURIãããã©ã¡ãŒã¿å€ãæœåºããŸãã
ã»URIãã³ãã¬ãŒãã«å«ãŸããªã颿°ãã©ã¡ãŒã¿ã«ã€ããŠã¯ãããã©ã«ãå€ã䜿çšããŸãã
ããã«ãããæè»ãªAPIèšèšãå¯èœã«ãªããŸããäŸãã°ããªãã·ã§ã³ãã©ã¡ãŒã¿ä»ãã®ã·ã³ãã«ãªæ€çŽ¢ãã³ãã¬ãŒãã¯æ¬¡ã®ããã«ãªããŸãã
from fastmcp import FastMCP
mcp = FastMCP(name="DataServer")
@mcp.resource("search://{query}")
def search_resources(query: str, max_results: int = 10, include_archived: bool = False) -> dict:
"""ã¯ãšãªæååã«äžèŽãããªãœãŒã¹ãæ€çŽ¢"""
# URIã§ã¯ãã¯ãšãªãã®ã¿ãå¿
èŠã§ãä»ã®ãã©ã¡ãŒã¿ã¯ããã©ã«ãã䜿çš
results = perform_search(query, limit=max_results, archived=include_archived)
return {
"query": query,
"max_results": max_results,
"include_archived": include_archived,
"results": results
}ãã®ãã³ãã¬ãŒãã䜿çšãããšãã¯ã©ã€ã¢ã³ã㯠search://python ããªã¯ãšã¹ãã§ããquery="python"ãmax_results=10ãinclude_archived=False ã§é¢æ°ãåŒã³åºãããŸããMCP éçºè ã¯ãããå ·äœçãªãã©ã¡ãŒã¿ãæå®ããŠãåºç€ãšãªã search_resources 颿°ãçŽæ¥åŒã³åºãããšãã§ããŸãã
ããã«åŒ·åãªãã¿ãŒã³ãšããŠã1ã€ã®é¢æ°ãè€æ°ã® URI ãã³ãã¬ãŒãã«ç»é²ããåãããŒã¿ã«è€æ°ã®æ¹æ³ã§ã¢ã¯ã»ã¹ã§ããããã«ããæ¹æ³ããããŸãã
from fastmcp import FastMCP
mcp = FastMCP(name="DataServer")
# ç°ãªãèå¥åã§ã¢ã¯ã»ã¹ã§ãããŠãŒã¶ãŒæ€çޢ颿°ãå®çŸ©
@mcp.resource("users://email/{email}")
@mcp.resource("users://name/{name}")
def lookup_user(name: str | None = None, email: str | None = None) -> dict:
"""ååãŸãã¯ã¡ãŒã«ã§ãŠãŒã¶ãŒãæ€çŽ¢"""
if email:
return find_user_by_email(email) # ç䌌ã³ãŒã
elif name:
return find_user_by_name(name) # ç䌌ã³ãŒã
else:
return {"error": "ã«ãã¯ã¢ãããã©ã¡ãŒã¿ãæå®ãããŠããŸãã"}LLMãŸãã¯ã¯ã©ã€ã¢ã³ãã¯ã以äžã®2ã€ã®æ¹æ³ã§ãŠãŒã¶ãŒæ å ±ãååŸã§ããŸãã
ã»users://email/alice@example.com â ã¡ãŒã«ã¢ãã¬ã¹ïŒname=NoneïŒã§ãŠãŒã¶ãŒãæ€çŽ¢
ã»users://name/Bob â ã¡ãŒã«ã¢ãã¬ã¹ïŒemail=NoneïŒã§ãŠãŒã¶ãŒãæ€çŽ¢
ãã®ã¹ã¿ãã¯ãã³ã¬ãŒã¿ãã¿ãŒã³ã§ã¯ã次ã®ããã«ãªããŸãã
ã»nameãã©ã¡ãŒã¿ã¯ãusers://name/{name}ãã³ãã¬ãŒãã䜿çšããå Žåã«ã®ã¿æäŸãããŸãã
ã»emailãã©ã¡ãŒã¿ã¯ãusers://email/{email}ãã³ãã¬ãŒãã䜿çšããå Žåã«ã®ã¿æäŸãããŸãã
ã»åãã©ã¡ãŒã¿ã¯ãURIã«å«ãŸããŠããªãå Žåãããã©ã«ãã§Noneã«ãªããŸãã
ã»é¢æ°ããžãã¯ã¯ãæäŸããããã©ã¡ãŒã¿ãåŠçããŸãã
ã»ãã³ãã¬ãŒãã®åäœ
(1) å®çŸ©
FastMCP ã¯ã@resource URI å ã® {...} ãã¬ãŒã¹ãã«ããšããã«äžèŽãã颿°ãã©ã¡ãŒã¿ãæ€åºãããšãResourceTemplate ãç»é²ããŸãã
(2) æ€åº
ã¯ã©ã€ã¢ã³ã㯠resources/listResourceTemplates çµç±ã§ãã³ãã¬ãŒããäžèŠ§è¡šç€ºããŸãã
(3) ãªã¯ãšã¹ããšãããã³ã°
ã¯ã©ã€ã¢ã³ããç¹å®ã® URI (äŸ: weather://london/current) ããªã¯ãšã¹ããããšãFastMCP ã¯ããã weather://{city}/current ãã³ãã¬ãŒããšãããã³ã°ããŸãã
(4) ãã©ã¡ãŒã¿æœåº
ãã©ã¡ãŒã¿å€ (city="london") ãæœåºããŸãã
(5) å倿ãšé¢æ°åŒã³åºã
æœåºããå€ã颿°å ã§ãã³ããããåã«å€æããget_weather(city="london") ãåŒã³åºããŸãã
(6) ããã©ã«ãå€
URI ãã³ãã¬ãŒãã«å«ãŸããŠããªãããã©ã«ãå€ãæã€é¢æ°ãã©ã¡ãŒã¿ã«ã€ããŠã¯ãFastMCP ã¯ããã©ã«ãå€ã䜿çšããŸãã
(7) ã¬ã¹ãã³ã¹
颿°ã®æ»ãå€ã¯ãã©ãŒããã (äŸ: dict ãã JSON) ããããªãœãŒã¹ã³ã³ãã³ããšããŠè¿ãããŸãã
ãã³ãã¬ãŒãã¯ãRESTã®ãããªååã«åŸã£ãŠãã©ã¡ãŒã¿åãããããŒã¿ã¢ã¯ã»ã¹ãã€ã³ããå ¬éãã匷åãªæ¹æ³ãæäŸããŸãã
12. ãµãŒãã®åäœ
12-1. éè€ãªãœãŒã¹
FastMCPãµãŒããåãURIã«è€æ°ã®ãªãœãŒã¹ãŸãã¯ãã³ãã¬ãŒããç»é²ããããšããå Žåã®åŠçââæ¹æ³ãèšå®ã§ããŸããFastMCPã®åæåæã«on_duplicate_resourcesèšå®ã䜿çšããŠãã ããã
from fastmcp import FastMCP
mcp = FastMCP(
name="ResourceServer",
on_duplicate_resources="error" # éè€ãããå Žåã¯ãšã©ãŒãçºç
)
@mcp.resource("data://config")
def get_config_v1(): return {"version": 1}
# "data://config" ã¯ãã§ã«ç»é²ãããŠãããåäœã¯ "error" ã§ããããã
# ãã®ç»é²ã®è©Šè¡ã§ã¯ ValueError ãçºç
# @mcp.resource("data://config")
# def get_config_v2(): return {"version": 2}ã»warn (ããã©ã«ã)
èŠåããã°ã«èšé²ããæ°ãããªãœãŒã¹/ãã³ãã¬ãŒããå€ããã®ã眮ãæããŸãã
ã»error
ValueError ãçºçãããéè€ç»é²ã鲿¢ããŸãã
ã»replace
æ¢åã®ãªãœãŒã¹/ãã³ãã¬ãŒããæ°ãããã®ã«çœ®ãæããŸãã
ã»ignore
å ã®ãªãœãŒã¹/ãã³ãã¬ãŒããä¿æããæ°ããç»é²ã®è©Šè¡ãç¡èŠããŸãã