Skip to main content

MCP server for interacting with Keboola Skill Registry

Project description

Keboola MCP Server

A Model Context Protocol (MCP) server that reveals skills exposed by the Keboola Skill Registry. This allows Claude to access and use tools from Keboola's Skill Registry directly within your conversations.

Requirements

  • Keboola Skill Registry API Token (Skill Group)

Installation

PyPI Installation (Recommended)

You can install the package directly from PyPI:

pip install keboola.skill_registry_mcp

Manual Installation

First, clone the repository and create a virtual environment:

git clone https://github.com/keboola/keboola-mcp-server.git
cd keboola-mcp-server
python3 -m venv .venv
source .venv/bin/activate

Install the package in development mode:

pip3 install -e .

For development dependencies:

pip3 install -e ".[dev]"

Claude Desktop Setup

To use this server with Claude Desktop, follow these steps:

  1. Create or edit the Claude Desktop configuration file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Add one of the following configurations (based on your installation method):

Using PyPI Installation (Recommended)

{
  "mcpServers": {
    "skill_registry": {
      "command": "keboola-sr-mcp",
      "args": [
        "--transport",
        "stdio",
        "--log-level",
        "DEBUG",
        "--api-url",
        "https://ksr.canary-orion.keboola.dev/api"
      ],
      "env": {
        "SKILL_REGISTRY_TOKEN": "SKILL_GROUP_TOKEN_FROM_REGISTRY_SERVICE"
      }
    }
  }
}

Using Manual Installation

{
  "mcpServers": {
   "skill_registry": {
      "command": "/path/to/keboola-skill-registry-mcp-server/.venv/bin/python",
      "args": [
        "-m",
        "keboola.skill_registry_mcp",
        "--transport",
        "stdio",
        "--log-level",
        "DEBUG",
        "--api-url",
        "https://ksr.canary-orion.keboola.dev/api"
      ],
      "env": {
        "SKILL_REGISTRY_TOKEN": "SKILL_GROUP_TOKEN_FROM_REGISTRY_SERVICE",
        "PYTHONPATH": "/path/to/keboola-skill-registry-mcp-server/src"
      }
    }
  }
}

Replace:

  • /path/to/keboola-mcp-server with your actual path to the cloned repository
  • SKILL_REGISTRY_TOKEN with your skill registry API token (skill group token)

Available Tools

The server will include all tools that are exposed for the particular Skill Registry token. These tools will be automatically available to Claude when the MCP server is properly configured.

Development

To contribute to this project:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Run tests: pytest
  5. Submit a pull request

License

MIT License - see LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

keboola_skill_registry_mcp-0.0.6.tar.gz (9.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

keboola_skill_registry_mcp-0.0.6-py3-none-any.whl (10.6 kB view details)

Uploaded Python 3

File details

Details for the file keboola_skill_registry_mcp-0.0.6.tar.gz.

File metadata

File hashes

Hashes for keboola_skill_registry_mcp-0.0.6.tar.gz
Algorithm Hash digest
SHA256 456c6b7d9310ec8d878a1bc624673522d9a5c4ca62770a3a398e609beec7b2cc
MD5 5d5f5ab1a83e839357ab2745226f4552
BLAKE2b-256 0bb4827d35694deb70a0b80cfa27eeed46a6d9512f5547b9adb334621b605b3a

See more details on using hashes here.

File details

Details for the file keboola_skill_registry_mcp-0.0.6-py3-none-any.whl.

File metadata

File hashes

Hashes for keboola_skill_registry_mcp-0.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 b0e5f264578955a4f3172792e9c598d41fca88dae942f1ebbca890dc4ba70a1d
MD5 7dffc58da152711e4ed67c7b0b5a3253
BLAKE2b-256 a7557e3276e5e62863a1954b01854f06f7e50cc51caca50d8f3560b11fb8c984

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page