Simple MCP Client

by tjjd4

117 downloads
Not rated
GitHub

About

A sample project testing Model Context Protocol (MCP) server and client interaction.

Details

Author
tjjd4
Downloads
117
Categories
Developer Tools

- Demonstrates basic client-server communication with MCP
- Includes call_tool() and read_resource() functionality
- Requires Python 3.12+
- Uses standard tools like pip or uv
- Provides a ready‑to‑run test script

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 MCP Client
    Command (node, npx, python, etc.)

    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

Clone the repository, create and activate a Python virtual environment, install dependencies from pyproject.toml, then run the test script with python scripts/test_simple_mcp.py after setting PYTHONPATH to the project root.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "simple mcp client": {
            "simple-mcp-test": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv",
                    "#",
                    "using",
                    "python",
                    "and",
                    "pip"
                ]
            }
        }
    }
}

McpServers

{
    "simple-mcp-test": {
        "command": "python",
        "args": [
            "-m",
            "venv",
            ".venv",
            "#",
            "using",
            "python",
            "and",
            "pip"
        ]
    }
}

Simple MCP Client

This project provides a simple MCP (Multi-Client Protocol) implementation that demonstrates basic client-server communication capabilities.

Prerequisites

- Python 3.12+
- Python package manager (e.g., uv) # suggested

Installation

1. Clone the repository:

git clone https://github.com/tjjd4/simple-mcp-test.git
cd simple-mcp-test

2. Create and activate a virtual environment (recommended):

python -m venv .venv # using python and pip
uv venv # using uv

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

3. Install the required dependencies:

pip install -r pyproject.toml # using pip
uv run pip install -r pyproject.toml # using uv

Running the Simple MCP Client

The simple MCP implementation can be tested using the test_simple_mcp.py script. This script demonstrates basic functionality including call_tool(), read_resource(), etc.

To run the test script:

```bash

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.