Skip to main content
Glama
Sign In
mcp-toy

mcp-toy

by xiangshiyin
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

mcp-toy

Toy project to explore the MCP capability

MCP Servers

MCP servers can provide 3 main types of capabilities:

  • Resources - File-like data that can be read by clients

  • Tools - Functions that can be called by LLM

  • Prompts - Pre-written templates that can help users accomplish specific tasks

Claude desktop integration

Run mcp install server.py to load the MCP server to Claude, the corresponding config in ~/Library/Application\ Support/Claude/claude_desktop_config.json will be updated. Here is an example:

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/Users/xiangshiyin/Documents/Coding/mcp-toy/server.py"
      ]
    }
  }
}

Development mode

Run uv run mcp dev server.py to inspect the MCP server

Related MCP server: FastMCP Demo

References

  • Official intro [link]

    • Test MCP server on Claude [link]

    • National weather service (NWS) API [doc]

  • MCP python SDK [link]

  • Stepwise tutorials

  • uv

    • About pyproject.toml [link]

    • Packing Python projects [link]

    • Official doc [link]

    • Add local dependency [link]

      • Using workspaces [link]

Available Tools

1 tool
get_forecastB

Get weather forecast for a location.

Args:
    latitude: Latitude of the location
    longitude: Longitude of the location

Inputs: latitude (required), longitude (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    B3/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so no ambiguity is possible. The tool has a clear, distinct purpose.

    Naming Consistency5/5

    With a single tool, naming is inherently consistent. The name follows a clear verb_noun pattern.

    Tool Count1/5

    A server with one trivial tool is an extreme mismatch for any real-world use case. Far too few tools to be useful.

    Completeness1/5

    The tool surface is severely incomplete for a weather domain. Missing basic operations like current conditions, historical data, or forecasts for multiple days.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Basic MCP Server

      gurdasnijor
      A
      license
      Not graded
      quality
      D
      maintenance
      A minimal demonstration server showcasing MCP protocol capabilities including tools, resources, and prompts with basic examples like hello world functionality.
      6 npm
      MIT

    • FastMCP Demo

      gogouravr
      A
      license
      B
      quality
      D
      maintenance
      A demonstration TypeScript MCP server that showcases basic MCP concepts with simple tools (greeting, calculator), text resources, and prompt templates for learning the Model Context Protocol.
      2
      MIT

    • MCP Server

      Sandeep-Petwal
      A
      license
      Not graded
      quality
      D
      maintenance
      This MCP server provides tools like weather lookup and follows the Model Context Protocol for tool calling, resource sharing, and prompt templates.
      547 npm
      MIT