MCP Server Setup

🚀 FastMCP Server Project

This project provides a FastMCP server that allows you to define and run various tools. It supports multiple ways to run the server and provides different client implementation examples for different transmission protocols.

🚀 Quick Start

Prerequisites

• Make sure you have Python installed on your system.
• Install the necessary dependencies for the FastMCP server.

Example Code

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("DemoServer")

@mcp.tool()
def say_hello(name: str) -> str:
    """Say hello to someone.

    Args:
        name: The name of the person to say hello to.
    """
    return f"Hello, {name}! Nice to meet you."

if __name__ == "__main__":
    mcp.run()

📦 Installation

There are several ways to run your MCP server:

1. Development Mode with MCP Inspector

The easiest way to test your server is to use the MCP Inspector:

mcp dev server.py

This will run your server locally and connect it to the MCP Inspector, a web-based tool that allows you to directly interact with your server's tools and resources. This is very useful for testing.

2. Claude Desktop Integration

If you have Claude Desktop installed, you can install the server for use in Claude:

mcp install server.py

This will add your server to the Claude Desktop configuration, making it available for Claude.

3. Direct Execution (Only if Needed)

You can also run the server directly:

# Method 1: Run as a Python script
python server.py

# Method 2: Use UV (Recommended)
uv run server.py

🔧 Technical Details

What Happens When You Run an MCP Server?

When you run an MCP server:

1. The server initializes with the defined capabilities (tools, resources, etc.).
2. It starts listening for connections on a specific transmission protocol.

By default, MCP servers do not use traditional web server ports. Instead, they use one of the following:

• Standard I/O Transmission: The server communicates via standard input and output (default when using mcp run and integrating with Claude Desktop).
• SSE Transmission: HTTP-based communication (when explicitly configured).

If you want to expose your server over HTTP on a specific port, you need to modify the server to use SSE transmission:

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("MyServer", host="127.0.0.1", port=8050)

# Add your tools and resources here...

if __name__ == "__main__":
    mcp.run_with_sse_transmission()

💻 Usage Examples

Basic Usage

The following is an example of starting a server and using the say_hello tool:

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("DemoServer")

@mcp.tool()
def say_hello(name: str) -> str:
    """Say hello to someone.

    Args:
        name: The name of the person to say hello to.
    """
    return f"Hello, {name}! Nice to meet you."

if __name__ == "__main__":
    mcp.run()

Advanced Usage

Client Implementation Example Using Standard I/O

from subprocess import Popen, PIPE

# Start the server process
server = Popen(["python", "server.py"], stdout=PIPE)

# Wait for the server to be ready (more complex handshake is needed in actual implementation)
input("Press Enter to continue...")

# Call the say_hello tool
result = server.communicate(input=b'Hello\n')

print(result)

Client Implementation Example Using SSE

import requests

# Connect to the SSE endpoint
response = requests.get('http://localhost:8050/sse', stream=True)

# Read the stream data
for line in response.iter_lines():
    if line:
        print(line.decode())

📚 Documentation

Comparison of Two Transmission Methods

• Use Standard I/O if your client and server will run in the same process or if the server process is started directly from the client.
• Use HTTP if your server will run in a different location from the client, possibly on a different machine or in a container.

For most production backend integrations, the HTTP method provides better separation and scalability, while the standard I/O method may be more suitable for development or tightly coupled systems.