Azure / Azure/CosmosDBShell

M1. stdio transport for the MCP server

Open
#153 1 comment 0 reactions 0 assignees View on GitHub
agentic enhancement P0
Dominant language
C#
Stars
3
Forks
7
Avg merge
1d 12h
Merged PRs (30d)
14

Description

## Why

MCP is HTTP-only today (default port `6128`). The most common MCP client integration pattern (Claude Desktop, many IDE agents, sandboxed hosts) launches servers over **stdio**. HTTP-only is a hard compatibility wall and forces port management. With adoption growing across 60+ accounts, broadening client reach is the highest-leverage agent investment.

## Proposed behavior

- `--mcp-stdio` (or `--mcp --transport stdio`) starts the server on stdio; keep HTTP as an option.
- Document both transports in `docs/mcp.md`.

## Acceptance criteria

- Server usable from a stdio MCP client end-to-end.
- HTTP behavior unchanged.
- Tests cover transport selection.
- Docs updated.

---
_Filed from the Agentic & Automation Roadmap (`docs/agentic-roadmap.md`), item **M1**, Wave 1. Priority P0._

Contributor guide

Open the contributing guide

Research direction

Start by reading the MCP server behavior and CLI startup path, then review the proposed transport options in the issue. Use docs/mcp.md and the existing test layout to determine where transport selection is covered. Done means stdio works end-to-end, HTTP remains unchanged, transport selection is tested, and both transports are documented.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp
Domain
api, cli, documentation
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.