mcp-server

gabrieldsguilherme/mcp-server

3.1

If you are the rightful owner of mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A ready-to-use implementation of the Model Context Protocol (MCP) server that integrates with Claude AI models.

๐ŸŒ Claude MCP Server Quickstart

A ready-to-use implementation of the Model Context Protocol (MCP) server that integrates with Claude AI models.

๐Ÿ” Overview

This project provides a fully functional MCP server implementation that allows you to:

  • Connect Claude AI models through a standardized protocol
  • Process context-aware requests
  • Handle model responses efficiently
  • Streamline AI integrations in your applications

Built following the official MCP Server Quickstart guide.

โœจ Features

  • โœ… Complete MCP protocol implementation
  • โœ… Claude AI model integration
  • โœ… Context-aware request processing
  • โœ… Streaming response support
  • โœ… Easy configuration and setup
  • โœ… Well-documented codebase

๐Ÿ“‹ Prerequisites

  • Python 3.8+
  • Access to Claude AI API credentials
  • Basic understanding of REST APIs

๐Ÿš€ Installation

# Clone the repository
git clone https://github.com/gabrieldsguilherme/mcp-server.git
cd mcp-server

# Create and activate virtual environment
uv venv
source .venv/bin/activate

# Install dependencies
uv add "mcp[cli]" httpx

โš™๏ธ Configuration

1. Open your Claude Desktop configuration file

Open your Claude for Desktop App configuration at ~/Library/Application Support/Claude/claude_desktop_config.json in a text editor. Make sure to create the file if it doesnโ€™t exist.

2. Update your Claude Desktop configuration file

{
    "mcpServers": {
        "weather": {
            "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
                "run",
                "weather.py"
            ]
        }
    }
}

This tells Claude for Desktop:

a. Thereโ€™s an MCP server named โ€œweatherโ€

b. To launch it by running uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/weather run weather.py

3. Save the file and restart Claude for Desktop

๐Ÿ“– Usage

1. Ask Claude "Whatโ€™s the weather in Sacramento?"

2. Ask Claude "What are the active weather alerts in Texas?"