{"id":31032326,"url":"https://github.com/javaaidev/openapi-mcp-server","last_synced_at":"2025-09-14T00:57:14.316Z","repository":{"id":312413335,"uuid":"1047420616","full_name":"JavaAIDev/openapi-mcp-server","owner":"JavaAIDev","description":"Convert OpenAPI spec to MCP server","archived":false,"fork":false,"pushed_at":"2025-08-30T12:40:45.000Z","size":68,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-30T13:24:12.274Z","etag":null,"topics":["kotlin","mcp","mcp-server","openapi"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JavaAIDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"ko_fi":"alexcheng1982","github":"alexcheng1982"}},"created_at":"2025-08-30T11:36:49.000Z","updated_at":"2025-08-30T12:39:02.000Z","dependencies_parsed_at":"2025-08-30T13:24:21.778Z","dependency_job_id":"4e7a0130-e12f-4edb-bfd5-38a051e872e0","html_url":"https://github.com/JavaAIDev/openapi-mcp-server","commit_stats":null,"previous_names":["javaaidev/openapi-mcp-server"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/JavaAIDev/openapi-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JavaAIDev%2Fopenapi-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JavaAIDev%2Fopenapi-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JavaAIDev%2Fopenapi-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JavaAIDev%2Fopenapi-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JavaAIDev","download_url":"https://codeload.github.com/JavaAIDev/openapi-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JavaAIDev%2Fopenapi-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275047914,"owners_count":25396337,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-13T02:00:10.085Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["kotlin","mcp","mcp-server","openapi"],"created_at":"2025-09-14T00:57:12.980Z","updated_at":"2025-09-14T00:57:14.303Z","avatar_url":"https://github.com/JavaAIDev.png","language":"Kotlin","readme":"# OpenAPI MCP Server\n\nConvert OpenAPI spec to MCP server, OpenAPI operations as tools.\n\nThis MCP server uses stdio transport.\n\n## CLI Options\n\nWhen running the MCP server, an OpenAPI spec is required. It can be either a file path or URL.\n\nThe MCP server also provides options to filter operations to be converted as MCP tools. Filter conditions of the same type are combined using `OR`, while filter conditions of different types are combined using `AND`.\n\nCurrently supported filter conditions:\n\n| Condition    | CLI option               | Example                       |\n|--------------|--------------------------|-------------------------------|\n| HTTP method  | `--include-http-method`  | `--include-http-method=GET`   |\n| Path         | `--include-path`         | `--include-path=/holidays`    |\n| Operation Id | `--include-operation-id` | `--include-operation-id=Root` |\n| Tag          | `--include-tag`          | `--include-tag=info`          |\n\nYou can run the JAR file to see the CLI help.\n\n```\nUsage: openapi-mcp [-hV] [--include-http-method=\u003cincludeHttpMethods\u003e[,\n                   \u003cincludeHttpMethods\u003e...]]...\n                   [--include-operation-id=\u003cincludeOperationIds\u003e[,\n                   \u003cincludeOperationIds\u003e...]]... [--include-path=\u003cincludePaths\u003e\n                   [,\u003cincludePaths\u003e...]]... [--include-tag=\u003cincludeTags\u003e[,\n                   \u003cincludeTags\u003e...]]... \u003copenapiSpec\u003e\nRun OpenAPI MCP server\n      \u003copenapiSpec\u003e   File path or URL of OpenAPI spec\n  -h, --help          Show this help message and exit.\n      --include-http-method=\u003cincludeHttpMethods\u003e[,\u003cincludeHttpMethods\u003e...]\n                      Include operations with HTTP methods (comma separated)\n      --include-operation-id=\u003cincludeOperationIds\u003e[,\u003cincludeOperationIds\u003e...]\n                      Include operations with id (comma separated)\n      --include-path=\u003cincludePaths\u003e[,\u003cincludePaths\u003e...]\n                      Include operations with paths (comma separated)\n      --include-tag=\u003cincludeTags\u003e[,\u003cincludeTags\u003e...]\n                      Include operations with tags (comma separated)\n  -V, --version       Print version information and exit.\n```\n\n## How to Run\n\n### Standalone JAR file\n\nDownload latest [release JAR file](https://github.com/JavaAIDev/openapi-mcp-server/releases) and run it using `java -jar`.\n\n```sh\njava -jar openapi-mcp-server-0.1.2-all.jar https://api.apis.guru/v2/specs/canada-holidays.ca/1.8.0/openapi.json\n```\n\n### Container\n\nUse Docker or Podman to run the container.\n\n```sh\ndocker run -i ghcr.io/javaaidev/openapi-mcp-server https://api.apis.guru/v2/specs/canada-holidays.ca/1.8.0/openapi.json\n```\n","funding_links":["https://ko-fi.com/alexcheng1982","https://github.com/sponsors/alexcheng1982"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjavaaidev%2Fopenapi-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjavaaidev%2Fopenapi-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjavaaidev%2Fopenapi-mcp-server/lists"}