Bilka MCP Server
An MCP server for integrating with public APIs.
Setup
- Install
uvif you haven't already:
curl -LsSf https://astral.sh/uv/install.sh | sh
- Create and activate a virtual environment:
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
- Install dependencies:
uv add "mcp[cli]" httpx
Running the Server
To run the server: ``bash 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 withUSER_AGENT: The user agent string to use for API requests
Adding New Tools
To add new tools to the server:
- Create a new async function in
src/server.py - Decorate it with
@mcp.tool() - Add proper type hints and docstrings
- 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"
]
}
}
}










