Skip to content

Add MCP server adapter for structured agent tool access - #23

Draft
Arun Sekhar (achandmsft) wants to merge 1 commit into
mainfrom
feature/mcp-server-and-install-docs
Draft

Add MCP server adapter for structured agent tool access#23
Arun Sekhar (achandmsft) wants to merge 1 commit into
mainfrom
feature/mcp-server-and-install-docs

Conversation

@achandmsft

@achandmsft Arun Sekhar (achandmsft) commented Apr 8, 2026

Copy link
Copy Markdown
Collaborator

What this does

Adds mcp_server.py exposing the scanner, smoke test, model compatibility checker, and migration plan as structured MCP tools (stdio transport). Agents call these natively instead of shelling out to CLI scripts.

Tool Description
scan Scan directories for legacy Chat Completions patterns. Returns structured JSON.
smoke_test Test whether the configured Azure OpenAI deployment supports the Responses API.
check_models Query Azure ARM for model capabilities in a region. Returns support matrix.
migration_plan Get the recommended migration workflow and key API mappings.

Also adds:

  • mcp optional dependency in pyproject.toml
  • azure-openai-to-responses-mcp console script entry point
  • MCP server docs + repo structure update in README

Why

Scripts as entry point means agents shell out via execute and parse stdout. MCP gives structured I/O and works in sandboxed environments where execute is disabled.

Related

Comment thread README.md Outdated
Comment on lines +34 to +41
Clone this repo and open it alongside your app as a [multi-root workspace](https://code.visualstudio.com/docs/editor/multi-root-workspaces):

```bash
git clone https://github.com/Azure-Samples/azure-openai-to-responses.git
# File → Add Folder to Workspace… → select azure-openai-to-responses
```

The `@azure-openai-to-responses` agent and skill activate automatically.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe this is clumsy. Switching from single root to multi-root workspaces impact the experience in vscode: a lot of the extensions start asking you "which workspace" either on start or when running a command.

We should probably look for alternatives. Also I'm not sure that works for GH CP CLI users

Add mcp_server.py exposing scan, smoke_test, check_models, and
migration_plan as structured MCP tools (stdio transport). Agents call
these natively instead of shelling out to CLI scripts.

- Add mcp optional dependency to pyproject.toml
- Add azure-openai-to-responses-mcp console script entry point
- Add MCP server docs and repo structure update to README
@achandmsft
Arun Sekhar (achandmsft) force-pushed the feature/mcp-server-and-install-docs branch from 6d526b7 to 0665825 Compare April 10, 2026 21:59
@achandmsft Arun Sekhar (achandmsft) changed the title Add MCP server adapter and agent-specific install instructions Add MCP server adapter for structured agent tool access Apr 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants