Kiota MCP Server

MCP server that exposes all Kiota CLI commands as MCP tools for API client generation.

Overview

The Kiota MCP Server provides a Model Context Protocol interface to the Kiota CLI, enabling AI assistants and MCP clients to:

• 🔍 Search for API descriptions

• ⬇️ Download OpenAPI specifications

• ⚙️ Manage client configurations (add, edit, remove)

• 🚀 Generate type-safe API client code with automatic dependency detection

• ℹ️ Query language support and dependency information

Related MCP server: mcp-cli-catalog

Prerequisites

Before using the Kiota MCP Server, ensure you have:

• Node.js v20 LTS or higher

• MCP-compatible client (e.g., Claude Desktop, MCP Inspector)

Note: Kiota CLI is bundled as a dependency and will be installed automatically. No separate installation required.

Installation

npm install kiota-mcp

Usage

As MCP Server

Configure in your MCP client settings (e.g., Claude Desktop):

{
  "mcpServers": {
    "kiota": {
      "command": "npx",
      "args": ["kiota-mcp"]
    }
  }
}

Available Tools

The server exposes 7 MCP tools corresponding to Kiota CLI commands:

1. kiota_search - Search for API descriptions

2. kiota_download - Download OpenAPI specifications

3. kiota_client_add - Add new client configuration

4. kiota_client_edit - Update existing client configuration

5. kiota_client_generate - Generate API client code (with automatic --ebc flag)

6. kiota_client_remove - Remove client configuration

7. kiota_info - Query language support and dependencies

Quick Start

1. Search for an API

{
  "tool": "kiota_search",
  "params": {
    "searchTerm": "GitHub"
  }
}

2. Download OpenAPI Specification

{
  "tool": "kiota_download",
  "params": {
    "openApiUrl": "https://api.github.com/openapi.json",
    "outputPath": "./github-api-spec.json"
  }
}

3. Add Client Configuration

{
  "tool": "kiota_client_add",
  "params": {
    "clientName": "github-api",
    "openApiPath": "./github-api-spec.json",
    "language": "typescript",
    "outputPath": "./generated/github"
  }
}

4. Generate Client Code

{
  "tool": "kiota_client_generate",
  "params": {
    "clientName": "github-api"
  }
}

The tool automatically:

• Uses --ebc flag for error-based cancellation

• Runs kiota info to determine required dependencies

• Returns installation commands for dependencies

OpenAPI Requirements

The Kiota MCP Server works with:

• ✅ OpenAPI 3.0.x and 3.1.x specifications

• ✅ JSON and YAML formats

• ✅ Local file paths or HTTPS URLs

• ⚠️ Maximum file size: 10MB

Supported Languages

• TypeScript

• JavaScript

• C#

• Java

• Python

• Go

• PHP

• Ruby

• Swift

Query available languages with:

{
  "tool": "kiota_info",
  "params": {}
}

Environment

The server automatically sets KIOTA_CONFIG_PREVIEW=true for all Kiota CLI operations, enabling preview features.

Development

Build

npm run build

Test

# Run all tests
npm test

# Watch mode (TDD)
npm run test:watch

# Coverage report
npm run test:coverage

Lint

npm run lint
npm run lint:fix

Documentation

• User Guide

• API Reference

• Examples

• Troubleshooting

Architecture

• TypeScript 5.7+ with strict mode

• Vitest for testing (TDD workflow)

• MCP SDK for protocol implementation

• Kiota CLI delegation (no reimplementation)

License

MIT

Contributing

See CONTRIBUTING.md for development guidelines.

Constitution

This project follows strict development principles documented in .specify/memory/constitution.md:

• 🎯 OpenAPI-First Architecture

• 📘 TypeScript & Modern Tooling

• 🧪 Test-Driven Development (TDD) - NON-NEGOTIABLE

• 📚 Documentation Excellence

• 👤 User-Provided Specifications

• 💻 Local MVP Server