Skip to content

feat: Add new Microsoft based MCP server for OpenAPI using official tools #117

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

pomianowski
Copy link

@pomianowski pomianowski commented Jul 22, 2025

MCP Server Information

Server Name: mcp/openapi
Repository URL: https://github.com/lepoco/openapi.client
Brief Description:
mcp/openapi is a modern OpenAPI toolkit built using the official Microsoft OpenAPI.NET library, combined with ModelContextProtocol SDK. Unlike existing solutions, this server supports advanced introspection and manipulation of OpenAPI specifications.

README: https://github.com/lepoco/openapi.client/blob/main/README.md
LICENSE (MIT): https://github.com/lepoco/openapi.client/blob/main/LICENSE

It can:

  • Fetch OpenAPI documents from remote sources
  • Analyze and detect inconsistencies or schema issues
  • Generate structured curl commands

Currently provided tools:

Tool Description
get_list_of_operations Lists all operation IDs from a given OpenAPI or Swagger JSON document.
get_known_responses Lists all known responses for given operation IDs from a OpenAPI or Swagger JSON document.
validate_document Validates the structure and syntax of an OpenAPI JSON document.
generate_curl_command Generates a cURL command for a specific operation ID.
create_csharp_snippet Creates a simple HTTP request for a given operation ID.

Copilot Screen

This implementation aims to improve reliability and extensibility by aligning closely with the latest OpenAPI standards and Microsoft's maintained tooling.

Basic Requirements

  • Open Source: Uses acceptable license (Apache-2.0, MIT, BSD-2-Clause, BSD-3-Clause or other permissive license)
  • MCP Compliant: Implements MCP API specification
  • Active Development: Recent commits and maintained
  • Docker Artifact: Dockerfile
  • Documentation: Basic README and setup instructions
  • Security Contact: Method for reporting security issues

Submitter Checklist

  • This server meets the basic requirements listed above
  • I understand this will undergo automated and manual review.
  • I have tested the MCP Server using task validate -- --name SERVER_NAME
  • I have built the MCP Server using task build -- --tools SERVER_NAME

@pomianowski pomianowski requested a review from a team as a code owner July 22, 2025 14:25
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.

1 participant