home / mcp / product mcp server

Product MCP Server

Provides a local MCP server and Telegram bot integration to manage and query products via chat.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "balychevtsev-coder-mcp": {
      "url": "http://127.0.0.1:8000",
      "headers": {
        "MCP_SERVER_URL": "http://127.0.0.1:8000",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "TELEGRAM_API_TOKEN": "<TELEGRAM_API_TOKEN>"
      }
    }
  }
}

You run a local MCP server that powers an interactive product catalog accessible through a Telegram bot. It exposes HTTP endpoints for health checks and operations, and it also can be launched locally as a standard process. This setup lets you manage and query products via chat, while the server handles requests behind the scenes and connects to you MCP client.

How to use

To use the MCP server with the Telegram bot, first start the MCP server so the bot can reach its endpoints. The bot expects the base MCP URL to be available, and you should provide the required API tokens. You can run the server and bot on the same machine for development.

How to install

Prerequisites: Python installed on your system, plus basic shell access. You will also need pip to install dependencies.

Option 1 — Setup with the provided installation script (recommended)

Windows (CMD):
```
setup_env.bat
```

Windows (PowerShell):
```
powershell -ExecutionPolicy Bypass -File setup_env.ps1
```

Linux/macOS:
```
chmod +x setup_env.sh
./setup_env.sh

Option 2 — Manual environment setup with a virtual environment

Windows:
```
# Create virtual environment
python -m venv venv

# Activate (CMD)
venv\Scripts\activate.bat

# Activate (PowerShell)
.\venv\Scripts\Activate.ps1

# Install dependencies
pip install --upgrade pip
pip install -r requirements.txt
```

Linux/macOS:
```
# Create virtual environment
python3 -m venv venv

# Activate
source venv/bin/activate

# Install dependencies
pip install --upgrade pip
pip install -r requirements.txt

Option 3 — Without a virtual environment (not recommended)

In two separate terminals (or sequentially):
```
cd mcp_server
pip install -r requirements.txt
```
```
cd telegram_bot
pip install -r requirements.txt

Additional steps for installation flow

If you already have a working environment, you can proceed to configure environment variables and start the server and bot as described below.

What to do next

After installation, configure the environment, then start the MCP server and the Telegram bot in separate terminals. The server will listen for health checks and tool calls at the provided endpoints.