Note: This project is currently in early research phase. Breaking changes are expected.

MCP Server that allows admins to register custom tools, by installing python packages, to consistently and accurately answer user questions using data.

Sync dependencies:

uv sync

Run the tests:

uv run pytest

Run the server:

uv run mcp-ckan

To register remote tools just install a Python package that can register MCP tools for your particular datasets. You can see an example at https://github.com/okfn/mcp-ckan-examplepythontools

In a nutshell, you can extend by installing python plugins:

uv pip install "git+https://github.com/okfn/mcp-ckan"
uv pip install "git+https://github.com/okfn/mcp-ckan-examplepythontools"
uv run mcp-ckan

The MCP server is configured to load the tools at startup time by iterating throug all the installed python packages looking for mcp_ckan entrypoints.

The Plugin needs to:

1. Be a proper python pip-installable package:

uv init --package mcp-ckan-exampleplugin

2. Define a register_tools(mcp) function that register tools in a MCP Server:

def register_tools(mcp):
    @mcp.tool()
    def greetings_from_examplepythontools():
        return "Hello from mcp_ckan_examplepythontools!"

3. Register a new mcp_ckan entrypoint in the pyproject.toml file that calls the register_tools function.

[project.entry-points."mcp_ckan"]
mcp-ckan-examplepythontools = "mcp_ckan_examplepythontools:register_tools"

This (and other settings) can be configured via the settings.py file (or environment variables if defined).

• Set MCP_TRANSPORT=stdio (default) for local development and Claude Desktop integration
• Set MCP_TRANSPORT=http for remote infrastructure deployment
• Set MCP_HOST and MCP_PORT to control the server's host and port (default: 127.0.0.1:8063).

Create the file .vscode/mcp.json:

{
  "servers": {
    "mybcie-server": {
      "url": "http://127.0.0.1:8063",
      "type": "http"
    }
  },
  "inputs": []
}

This tool allows you to test tools locally without any AI model.

npx @modelcontextprotocol/inspector uv run mcp-ckan