README

KaitoMCPServer

Environment Setup

This project uses uv for dependency management and Python environment management.

Prerequisites

Python 3.13 or higher
uv package manager

Installation

Install uv (if not already installed):

# On macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or using Homebrew on macOS
brew install uv

Clone the repository:

git clone <repository-url>
cd KaitoMCPServer

Install dependencies:
```
uv sync
```
This will:
- Create a virtual environment automatically
- Install all project dependencies as specified in pyproject.toml
- Lock the dependencies in uv.lock

Running the Project

To run the MCP server:

uv run python main.py

To test the server functionality:

# Simple direct testing (recommended for development)
uv run python simple_client.py

# Full MCP protocol client (requires server to be running separately)
uv run python client.py

Testing

The project includes two client scripts for testing:

simple_client.py - Direct testing by importing server functions
client.py - Full MCP protocol client that communicates with a running server

For quick testing and development, use simple_client.py. For testing the actual MCP protocol implementation, run the server with main.py and then use client.py in a separate terminal.

Development

To activate the virtual environment for development:

uv shell

To add new dependencies:

uv add <package-name>

To add development dependencies:

uv add --dev <package-name>

KaitoMCPServer

README

KaitoMCPServer

Environment Setup

Prerequisites

Installation

Running the Project

Testing

Development

Recommended Servers