Simple Tool (Website Fetcher)

by myblockcities

2 stars
292 downloads
Not rated
GitHub

About

Integrates with web servers to fetch and retrieve webpage content for analysis and processing tasks.

Details

Author
myblockcities
Repository
MyBlockcities/mcp-server-heroku
GitHub stars
2
Downloads
292
License
MIT License
Categories
Productivity, Design, Developer Tools, AI, API, Infrastructure
Tags
#web

- Template for building custom Cursor IDE tools
- Supports both stdio and SSE transport protocols
- One-click deploy to Heroku
- Docker and traditional Python setup options
- Configurable via environment variables (.env)
- Integration with Smithery for Claude Desktop

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Simple Tool (Website Fetcher)
    Command (node, npx, python, etc.) uv
    Arguments
    • Argument 1 run
    • Argument 2 mcp-simple-tool
    Environment
    • DEBUG false
    • MCP_USER_AGENT MCP_USER_AGENT
    • MCP_SERVER_HOST 0.0.0.0
    • MCP_SERVER_PORT 8000

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. Click "Deploy to Heroku" button

Deploy to Heroku

2. After deployment, configure Cursor:
- Open Cursor Settings → Features
- Add new MCP server
- Use your Heroku URL with /sse path (e.g., https://<your-app-name>.herokuapp.com/sse)

3. Test your agent's mood in Cursor:
- Ask your agent "Please ask about our server mood and let me know how it is."
- The server will respond with a cheerful message and a heart ❤️

You can run the server in three ways: using Docker, traditional Python setup, or directly in Cursor IDE.

The project includes Docker support for easy deployment:

1. Initial setup:


cp .env.example .env

2. Build and run using Docker Compose:


First, install the uv package manager:

bash

brew install uv

pip install uv


Start the server using either stdio (default) or SSE transport:

bash

uv pip install -e ".[dev]"

Available environment variables (can be set in .env):

- MCP_SERVER_PORT (default: 8000) - Port to run the server on
- MCP_SERVER_HOST (default: 0.0.0.0) - Host to bind the server to
- DEBUG (default: false) - Enable debug mode
- MCP_USER_AGENT - Custom User-Agent for website fetching

smithery badge

To install MCP Server Template for Cursor IDE for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kirill-markin/example-mcp-server --client claude

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "simple tool (website fetcher)": {
            "env": {
                "DEBUG": "false",
                "MCP_USER_AGENT": "MCP_USER_AGENT",
                "MCP_SERVER_HOST": "0.0.0.0",
                "MCP_SERVER_PORT": "8000"
            },
            "args": [
                "run",
                "mcp-simple-tool"
            ],
            "command": "uv"
        }
    }
}

Linux

{
    "env": {
        "DEBUG": "false",
        "MCP_USER_AGENT": "MCP_USER_AGENT",
        "MCP_SERVER_HOST": "0.0.0.0",
        "MCP_SERVER_PORT": "8000"
    },
    "args": [
        "run",
        "mcp-simple-tool"
    ],
    "command": "uv"
}

Macos

{
    "env": {
        "DEBUG": "false",
        "MCP_USER_AGENT": "MCP_USER_AGENT",
        "MCP_SERVER_HOST": "0.0.0.0",
        "MCP_SERVER_PORT": "8000"
    },
    "args": [
        "run",
        "mcp-simple-tool"
    ],
    "command": "uv"
}

Windows

{
    "env": {
        "DEBUG": "false",
        "MCP_USER_AGENT": "MCP_USER_AGENT",
        "MCP_SERVER_HOST": "0.0.0.0",
        "MCP_SERVER_PORT": "8000"
    },
    "args": [
        "run",
        "mcp-simple-tool"
    ],
    "command": "uv"
}

MCP Server Template for Cursor IDE

A simple template for creating custom tools for Cursor IDE using Model Context Protocol (MCP). Create your own repository from this template, modify the tools, and connect them to your Cursor IDE.

Server Mood Response

Quick Start

1. Click "Deploy to Heroku" button

Deploy to Heroku

2. After deployment, configure Cursor:
- Open Cursor Settings → Features
- Add new MCP server
- Use your Heroku URL with /sse path (e.g., https://<your-app-name>.herokuapp.com/sse)

3. Test your agent's mood in Cursor:
- Ask your agent "Please ask about our server mood and let me know how it is."
- The server will respond with a cheerful message and a heart ❤️

Alternative Setup Methods

You can run the server in three ways: using Docker, traditional Python setup, or directly in Cursor IDE.

Docker Setup

The project includes Docker support for easy deployment:

1. Initial setup:

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

Create environment file

cp .env.example .env

2. Build and run using Docker Compose:

# Build and start the server
docker compose up --build -d

View logs

docker compose logs -f

Check server status

docker compose ps

Stop the server

docker compose down

3. The server will be available at:
- SSE endpoint: http://localhost:8000/sse

4. Quick test:

# Test the server endpoint
curl -i http://localhost:8000/sse

5. Connect to Cursor IDE:
- Open Cursor Settings → Features
- Add new MCP server
- Type: Select "sse"
- URL: Enter http://localhost:8000/sse

Traditional Setup

First, install the uv package manager:

# Install uv on macOS
brew install uv

Or install via pip (any OS)

pip install uv

Start the server using either stdio (default) or SSE transport:

# Install the package with development dependencies
uv pip install -e ".[dev]"

Using stdio transport (default)

uv run mcp-simple-tool

Using SSE transport on custom port

uv run mcp-simple-tool --transport sse --port 8000

Run tests

uv run pytest -v

After installation, you can connect the server directly to Cursor IDE:

1. Right-click on the cursor-run-mcp-server.sh file in Cursor
2. Select "Copy Path" to copy the absolute path
3. Open Cursor Settings (gear icon)
4. Navigate to Features tab
5. Scroll down to "MCP Servers"
6. Click "Add new MCP server"
7. Fill in the form:
- Name: Choose any name (e.g., "my-mcp-server-1")
- Type: Select "stdio" (not "sse" because we run the server locally)
- Command: Paste the absolute path to cursor-run-mcp-server.sh that you copied earlier. For example: /Users/kirillmarkin/weaviate-mcp-server/cursor-run-mcp-server.sh

Environment Variables

Available environment variables (can be set in .env):

- MCP_SERVER_PORT (default: 8000) - Port to run the server on
- MCP_SERVER_HOST (default: 0.0.0.0) - Host to bind the server to
- DEBUG (default: false) - Enable debug mode
- MCP_USER_AGENT - Custom User-Agent for website fetching

Additional options

Installing via Smithery

smithery badge

To install MCP Server Template for Cursor IDE for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kirill-markin/example-mcp-server --client claude

Glama server review

<a href="https://glama.ai/mcp/servers/jgisqn8zco">Server Template for Cursor IDE MCP server</a>

No reviews yet — be the first

Sign in to leave a review

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

Email sign in

No reviews posted yet.