🚀 Build Custom MCP Servers 📝☀️📰

by sourangshupal

6 stars

306 downloads

Not rated

GitHub

Developer Tools

Description

# 🚀 Build Custom MCP Servers 📝☀️📰 ## 📖 Project Description This project demonstrates a simple MCP Servers built using the MCP `mcp[cli]` Python SDK. It provides several tools exposed through the MCP server: * **Note Management:** Add, read, retrieve the latest, and generate…

About

Details

Author: sourangshupal
GitHub stars: 6
Downloads: 306
Categories: Developer Tools

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name 🚀 Build Custom MCP Servers 📝☀️📰

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "\ud83d\ude80 build custom mcp servers \ud83d\udcdd\u2600\ufe0f\ud83d\udcf0": {
            "Build-Custom-MCP-Servers": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 build custom mcp servers \ud83d\udcdd\u2600\ufe0f\ud83d\udcf0": {
            "Build-Custom-MCP-Servers": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 build custom mcp servers \ud83d\udcdd\u2600\ufe0f\ud83d\udcf0": {
            "Build-Custom-MCP-Servers": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "\ud83d\ude80 build custom mcp servers \ud83d\udcdd\u2600\ufe0f\ud83d\udcf0": {
            "Build-Custom-MCP-Servers": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 build custom mcp servers \ud83d\udcdd\u2600\ufe0f\ud83d\udcf0": {
            "Build-Custom-MCP-Servers": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 build custom mcp servers \ud83d\udcdd\u2600\ufe0f\ud83d\udcf0": {
            "Build-Custom-MCP-Servers": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "\ud83d\ude80 build custom mcp servers \ud83d\udcdd\u2600\ufe0f\ud83d\udcf0": {
            "Build-Custom-MCP-Servers": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 build custom mcp servers \ud83d\udcdd\u2600\ufe0f\ud83d\udcf0": {
            "Build-Custom-MCP-Servers": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 build custom mcp servers \ud83d\udcdd\u2600\ufe0f\ud83d\udcf0": {
            "Build-Custom-MCP-Servers": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "\ud83d\ude80 build custom mcp servers \ud83d\udcdd\u2600\ufe0f\ud83d\udcf0": {
            "Build-Custom-MCP-Servers": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 build custom mcp servers \ud83d\udcdd\u2600\ufe0f\ud83d\udcf0": {
            "Build-Custom-MCP-Servers": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 build custom mcp servers \ud83d\udcdd\u2600\ufe0f\ud83d\udcf0": {
            "Build-Custom-MCP-Servers": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "\ud83d\ude80 build custom mcp servers \ud83d\udcdd\u2600\ufe0f\ud83d\udcf0": {
            "Build-Custom-MCP-Servers": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 build custom mcp servers \ud83d\udcdd\u2600\ufe0f\ud83d\udcf0": {
            "Build-Custom-MCP-Servers": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 build custom mcp servers \ud83d\udcdd\u2600\ufe0f\ud83d\udcf0": {
            "Build-Custom-MCP-Servers": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

From the repository

Install Python 3.12 and a virtual environment manager. Clone the repository, set up a virtual environment, and install dependencies (e.g., uv sync). Copy .env.example to .env and add your WEATHER_API_KEY and BRAVE_API_KEY. Run the server with mcp install main.py to add it to Claude Desktop, or use mcp dev main.py for development.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "\ud83d\ude80 build custom mcp servers \ud83d\udcdd\u2600\ufe0f\ud83d\udcf0": {
            "Build-Custom-MCP-Servers": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

McpServers

{
    "Build-Custom-MCP-Servers": {
        "command": "uv",
        "args": [
            "sync"
        ]
    }
}

🚀 Build Custom MCP Servers 📝☀️📰

📖 Project Description

This project demonstrates a simple MCP Servers built using the MCP mcp[cli] Python SDK. It provides several tools exposed through the MCP server:

Note Management: Add, read, retrieve the latest, and generate summaries of notes stored locally.
Weather Information: Fetch current weather data for a specified city using the WeatherAPI.com service.
News Search: Perform news searches using the Brave Search API.

It utilizes API keys stored in a .env file for external services.

🛠️ Setup Instructions

Follow these steps to get the FastMCP agent running:

1. Prerequisites:
Python 3.12 installed.
A virtual environment manager (like venv, pipenv, poetry, or uv) is recommended.

2. Clone the Repository (if you haven't already):

# Make sure you are in the correct parent directory git clone https://github.com/sourangshupal/Build-Custom-MCP-Servers # Or use the current directory if already cloned cd Build-Custom-MCP-Servers

3. Set up Virtual Environment & Install Dependencies:
Install dependencies (assuming uv, based on uv.lock, otherwise adjust for pip/poetry):

        uv sync

        uv lock

        source .venv/bin/activate  # On Windows use .venv\Scripts\activate

OR

pip install uv # if you don't have uv uv pip install -r requirements.txt # Or uv sync if using pyproject.toml directly # If not using uv, likely: pip install -r requirements.txt or poetry install or pip install .

4. Configure Environment Variables:
Copy the example environment file:

        cp .env.example .env

Edit the newly created .env file and add your API keys:

WEATHER_API_KEY="YOUR_WEATHER_API_KEY" BRAVE_API_KEY="YOUR_BRAVE_API_KEY"

5. Run the Agent:
Execute the main script:

        mcp install main.py

The FastMCP server should be added to Claude Desktop.

mcp dev main.py
Debug the MCP Server

✨ Features

Note-taking capabilities (add, read, latest, summarize) 📝
Current weather fetching ☀️
Brave Search integration for news 📰
Configuration via .env file 🔑

Built with mcp[cli] ⚙️

🤝 Contributing

Contributions are welcome! Please feel free to submit pull requests or open issues.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

🚀 Build Custom MCP Servers 📝☀️📰

📖 Project Description

🛠️ Setup Instructions

✨ Features

🤝 Contributing

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright