{"id":24124,"date":"2025-04-30T23:41:53","date_gmt":"2025-05-01T06:41:53","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=24124"},"modified":"2025-04-30T23:41:53","modified_gmt":"2025-05-01T06:41:53","slug":"dev-proxy-v0-27-with-generating-typespec-files-and-configuring-using-natural-language","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/dev-proxy-v0-27-with-generating-typespec-files-and-configuring-using-natural-language\/","title":{"rendered":"Dev Proxy v0.27 with generating TypeSpec files and configuring using natural language"},"content":{"rendered":"<p>We\u2019re excited to announce the release of Dev Proxy v0.27. This version focuses on making Dev Proxy even more developer-friendly, helping you generate API specs faster, improving suggestions while editing, and laying the foundation for more flexible AI integrations.<\/p>\n<p>In this version:<\/p>\n<ul>\n<li>Generate TypeSpec definitions from requests<\/li>\n<li>Experimental Dev Proxy MCP server<\/li>\n<li>Refactored local language model connection for more hosts<\/li>\n<li>Extended JSON schemas with descriptions<\/li>\n<li>Improved intercepting URLs and reloading mocks on change<\/li>\n<\/ul>\n<h2>Generate TypeSpec definitions from requests<\/h2>\n<p>In addition to generating OpenAPI specifications from intercepted requests, Dev Proxy can now generate TypeSpec definitions!<\/p>\n<p><a href=\"https:\/\/typespec.io\/\">TypeSpec<\/a> is a new way to model APIs and generate code across ecosystems. The more your API evolves, the more benefit you get from using TypeSpec. With this update, you can use Dev Proxy to quickly scaffold TypeSpec definitions from real traffic\u2014helping you get started with API modeling even faster.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/Screenshot-2025-04-29-151434.png\"><img decoding=\"async\" class=\"aligncenter size-full wp-image-24128\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/Screenshot-2025-04-29-151434.png\" alt=\"Screenshot\" width=\"1727\" height=\"1005\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/Screenshot-2025-04-29-151434.png 1727w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/Screenshot-2025-04-29-151434-300x175.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/Screenshot-2025-04-29-151434-1024x596.png 1024w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/Screenshot-2025-04-29-151434-768x447.png 768w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/Screenshot-2025-04-29-151434-1536x894.png 1536w\" sizes=\"(max-width: 1727px) 100vw, 1727px\" \/><\/a><\/p>\n<p style=\"text-align: center;\"><em>Dev Proxy generates a TypeSpec definition for an API.<\/em><\/p>\n<p>Generating TypeSpec definitions using Dev Proxy works the same way as generating OpenAPI specs. Also here, for the best results, we suggest that you use a language model to get more accurate and readable operation descriptions.<\/p>\n<p>Learn more about <a href=\"https:\/\/learn.microsoft.com\/microsoft-cloud\/dev\/dev-proxy\/technical-reference\/typespecgeneratorplugin\">generating TypeSpec definitions<\/a> using Dev Proxy.<\/p>\n<p>Thanks to <a href=\"https:\/\/github.com\/tomorgan\">Tom Morgan<\/a> and <a href=\"https:\/\/github.com\/pkbullock\">Paul Bullock<\/a> for early testing this feature and feedback.<\/p>\n<h2>Experimental Dev Proxy MCP server<\/h2>\n<p>We\u2019re excited to announce an experimental Dev Proxy MCP server! Use our server to:<\/p>\n<ul>\n<li>Create Dev Proxy configurations using natural language<\/li>\n<li>Get contextual help for working with Dev Proxy<\/li>\n<li>Discover Dev Proxy features and capabilities<\/li>\n<\/ul>\n<p>For a long time, we\u2019ve wanted to let you configure Dev Proxy using natural language. Dev Proxy offers many features and supports a wide range of scenarios, but if you\u2019re not using it regularly, it might take you a while to discover what\u2019s possible and how to correctly configure Dev Proxy. With the advancements in LLMs we&#8217;ve been getting closer and closer to this ability. The recent support for MCP (Model Context Protocol) servers was the final piece of the puzzle that we needed. Using a custom MCP server, we can provide AI agents with the necessary information about Dev Proxy to help you configure it for your needs!<\/p>\n<p>Here are some examples of how you can use our MCP server with the GitHub Copilot agent in Visual Studio Code:<\/p>\n<p style=\"text-align: center;\"><img decoding=\"async\" width=\"2562\" height=\"1728\" class=\"wp-image-24125\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-2.png\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-2.png 2562w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-2-300x202.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-2-1024x691.png 1024w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-2-768x518.png 768w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-2-1536x1036.png 1536w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-2-2048x1381.png 2048w\" sizes=\"(max-width: 2562px) 100vw, 2562px\" \/><em>GitHub Copilot in Agent mode creating a Dev Proxy configuration for simulating Microsoft Graph behaviors using the Dev Proxy MCP server<\/em><\/p>\n<p style=\"text-align: center;\"><img decoding=\"async\" width=\"2562\" height=\"1318\" class=\"wp-image-24126\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-3.png\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-3.png 2562w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-3-300x154.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-3-1024x527.png 1024w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-3-768x395.png 768w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-3-1536x790.png 1536w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-3-2048x1054.png 2048w\" sizes=\"(max-width: 2562px) 100vw, 2562px\" \/><em>GitHub Copilot in Agent mode creating a Dev Proxy configuration for simulating latency on a public API using the Dev Proxy MCP server<\/em><\/p>\n<p>If you use Visual Studio Code insiders, you can get our MCP server from an <a href=\"https:\/\/github.com\/garrytrinder\/dev-proxy-toolkit\/releases\/tag\/mcp.1\">experimental version of the Dev Proxy Toolkit<\/a>. Otherwise, get it from <a href=\"https:\/\/www.npmjs.com\/package\/@devproxy\/mcp\">npm<\/a> and follow the instructions for your MCP host to use it.<\/p>\n<p>Try it and let us know! We\u2019d love to hear from you what\u2019s working and what else we should consider <a id=\"post-24124-_Int_1n4LOoZZ\"><\/a>to make it better for you.<\/p>\n<h2>Refactored local LLM connection for broader AI host support<\/h2>\n<p>We\u2019ve refactored the local Language Model (LM) connection to make it generic. Previously, the connection logic was tightly coupled to Ollama. With this update, we\u2019re introducing support for connecting Dev Proxy to <em>any language model client<\/em> that exposes OpenAI-compatible APIs, making it easier to connect to the AI providers you prefer.<\/p>\n<p>By default, Dev Proxy uses Ollama, but you can specify the <a href=\"https:\/\/learn.microsoft.com\/microsoft-cloud\/dev\/dev-proxy\/how-to\/use-language-model#configure-dev-proxy-to-use-a-local-language-model\">URL<\/a> of a different language model client in Dev Proxy\u2019s configuration settings.<\/p>\n<h2>Enhanced JSON schemas with descriptions and markdown<\/h2>\n<p>We&#8217;ve updated our JSON schemas to include descriptions. When editing your Dev Proxy configuration in Visual Studio Code, you&#8217;ll now see additional information about each property &#8211; making it easier to understand each property and configure Dev Proxy correctly.<\/p>\n<p style=\"text-align: center;\"><img decoding=\"async\" width=\"1260\" height=\"1106\" class=\"wp-image-24127\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-4.png\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-4.png 1260w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-4-300x263.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-4-1024x899.png 1024w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/04\/word-image-24124-4-768x674.png 768w\" sizes=\"(max-width: 1260px) 100vw, 1260px\" \/><em>Additional information about properties visible thanks to updated schemas.<\/em><\/p>\n<h2>Improved intercepting URLs and reloading mocks on change<\/h2>\n<p>When changing a mock file while Dev Proxy was running on Windows, the file watcher would previously reload the mock multiple times. We&#8217;ve fixed this issue to ensure that Dev Proxy now <strong>reloads the mock file just once<\/strong>, improving performance and stability. We\u2019ve also improved defining URLs to follow and exclude.<\/p>\n<h2>There\u2019s more<\/h2>\n<p>This release also includes several bug fixes and improvements. Check out the <a href=\"https:\/\/github.com\/microsoft\/dev-proxy\/releases\/tag\/v0.27.0\">release notes<\/a> for the complete list of changes in this version.<\/p>\n<h2>New version of Dev Proxy Toolkit<\/h2>\n<p>Dev Proxy Toolkit is a Visual Studio Code extension that makes it easy to create and update configuration files. Alongside the new release of Dev Proxy, we\u2019ve also released a new version of the toolkit, v0.22.0.<\/p>\n<p>In this version, we\u2019ve included:<\/p>\n<ul>\n<li>Added two new commands\n<ul>\n<li>Create a new configuration file<\/li>\n<li>Restart Dev Proxy<\/li>\n<\/ul>\n<\/li>\n<li>Updated all code snippets to use the latest schema<\/li>\n<li>Added snippets for the TypeSpecGeneratorPlugin and its related configuration section<\/li>\n<\/ul>\n<p>Checkout the <a href=\"https:\/\/marketplace.visualstudio.com\/items\/garrytrinder.dev-proxy-toolkit\/changelog\">changelog<\/a> for more information on changes and bug fixes.<\/p>\n<h2>Try it now<\/h2>\n<p><a href=\"https:\/\/learn.microsoft.com\/microsoft-cloud\/dev\/dev-proxy\/get-started\/set-up\">Download Dev Proxy v0.27<\/a> or pull the new Docker image and build better, more secure apps faster than ever.<\/p>\n<p>Have questions or feedback? Join our <a href=\"https:\/\/aka.ms\/devproxy\/discord\">Discord community<\/a> and let us know what you think.<\/p>\n<p><em>Follow us on <\/em><a href=\"http:\/\/twitter.com\/microsoft365dev\"><em>X,<\/em><\/a><em><a href=\"http:\/\/linkedin.com\/showcase\/microsoft365dev\">\u00a0LinkedIn<\/a>, and subscribe to our <\/em><a href=\"https:\/\/www.youtube.com\/microsoft365developer\"><em>YouTube<\/em><\/a> channel <em>to stay up to date on the latest developer news and announcements.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Dev Proxy v0.27 is even more developer-friendly, helping you generate API specs faster, improving suggestions while editing, and laying the foundation for more flexible AI integrations.<\/p>\n","protected":false},"author":74222,"featured_media":24131,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[289,384,325,398,399,44],"class_list":["post-24124","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-365-developer","tag-dev-proxy","tag-dev-proxy-toolkit","tag-json","tag-mcp","tag-typespec","tag-visual-studio-code"],"acf":[],"blog_post_summary":"<p>Dev Proxy v0.27 is even more developer-friendly, helping you generate API specs faster, improving suggestions while editing, and laying the foundation for more flexible AI integrations.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/24124","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/74222"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=24124"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/24124\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/24131"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=24124"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=24124"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=24124"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}