DEV Community

Mihai Ciprian Chezan
Mihai Ciprian Chezan

Posted on

I built Teukhos to wrap any CLI tool as an MCP server with just a YAML file

Tired of writing Python boilerplate every time I wanted to expose a CLI tool via MCP, I built Teukhos.

You describe your tool in YAML. One command. Done! Available to any AI client (Claude, Cursor, Copilot, Gemini CLI...).

pip install teukhos
teukhos serve my-tools.yaml
Enter fullscreen mode Exit fullscreen mode

A minimal example:

forge:
  name: "git-tools"
tools:
  - name: git_log
    description: "Show recent git commits"
    adapter: cli
    cli:
      command: git
      subcommand: [log, --oneline]
    args:
      - name: count
        type: integer
        flag: "-n"
        default: 10
    output:
      type: stdout
Enter fullscreen mode Exit fullscreen mode

Basically, it enables config-as-code for MCP. Version-controlled, CI/CD-friendly, no Python required.

GitHub: https://github.com/MihaiCiprianChezan/Teukhos

Currently in beta (v0.3.7), 15 supported clients, 62 integration tests passing.

Feedback welcome!

Top comments (0)