Bilka Server

An MCP server for integrating with public APIs.

Setup

1. Install uv if you haven't already:

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. Create and activate a virtual environment:

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

3. Install dependencies:

   uv add "mcp[cli]" httpx
   

Running the Server

To run the server:

python src/server.py

Configuration

The server can be configured by modifying the constants in src/server.py:

• API_BASE: The base URL for the API you're integrating with
• USER_AGENT: The user agent string to use for API requests

Adding New Tools

To add new tools to the server:

1. Create a new async function in src/server.py
2. Decorate it with @mcp.tool()
3. Add proper type hints and docstrings
4. Implement the tool's functionality

Testing with Claude for Desktop

To use this server with Claude for Desktop, add the following to your claude_desktop_config.json:

{
    "mcpServers": {
        "bilka": {
            "command": "python",
            "args": [
                "src/server.py"
            ]
        }
    }
}