MCP Ynu

🚀 MCP-YNU - FastMCP Server

A dynamic MCP server implemented with FastMCP that can automatically load tools, resources, and prompts from corresponding directories.

🚀 Quick Start

1. Create modules in the appropriate directories.
2. Import MCP via from mcp_server import mcp.
3. Run the server:

python main.py

✨ Features

• Dynamically load modules from the tools/, resources/, and prompts/ directories.
• Automatically discover and register modules.
• Simple configuration and extensibility.
• Code with type hints to improve code clarity and static analysis capabilities.
• Comprehensive logging to monitor server activities.

🔄 Recent Updates

• Added type hints throughout the codebase.
• Improved MCP instance handling.
• Added logging functionality.
• Added the MIT license.
• Updated reference links in the documentation.

📁 Directory Structure

mcp-ynu/
├── tools/          # Tool module directory
│   ├── __init__.py
│   ├── example.py
├── resources/      # Resource module directory
│   ├── __init__.py
│   ├── example.py
├── prompts/        # Prompt module directory
│   ├── __init__.py
│   ├── example.py
├── logger.py       # Logging implementation
├── main.py         # Main program implementation
├── mcp_server.py   # MCP server implementation
├── README.md       # Project documentation
├── LICENSE         # MIT license
└── pyproject.toml  # Project configuration

💻 Usage Examples

Basic Usage

Tool Module Example (tools/example.py)

from mcp_server import mcp
import httpx

@mcp.tool()
def calculate_bmi(weight_kg: float, height_m: float) -> float:
    """Calculate BMI based on weight (kg) and height (m)"""
    return weight_kg / (height_m**2)


@mcp.tool()
async def fetch_weather(city: str) -> str:
    """Get the current weather for the specified city"""
    async with httpx.AsyncClient() as client:
        response = await client.get(f"https://api.weather.com/{city}")
        return response.text

Resource Module Example (resources/example.py)

from mcp_server import mcp

@mcp.resource("config://app")
def get_config() -> str:
    """Static configuration data"""
    return "Application configuration information"


@mcp.resource("users://{user_id}/profile")
def get_user_profile(user_id: str) -> str:
    """Dynamic user data"""
    return f"Profile information for user {user_id}"

Prompt Module Example (prompts/example.py)

from mcp_server import mcp
from mcp.server.fastmcp.prompts import base

@mcp.prompt()
def review_code(code: str) -> str:
    return f"Please review the following code:\n\n{code}"


@mcp.prompt()
def debug_error(error: str) -> list[base.Message]:
    return [
        base.UserMessage("I'm seeing this error:"),
        base.UserMessage(error),
        base.AssistantMessage("I'll help you debug."),
    ]

🐞 Debugging Steps

1. Set the environment variable MCP_DEBUG=1 to enable debug mode.
2. Run the server command in the terminal:

python main.py --debug

3. Check the console output for debugging information.

📋 Requirements

• Python 3.8 or higher is required.
• FastMCP and related dependencies need to be installed.

🔗 Reference Links

• FastMCP Official Documentation
• Python Official Documentation

📄 License

This project is protected by the MIT license. See LICENSE for detailed information.