WinFormsApp-MCP
- agent-framework
WinFormsApp-MCP Windows Forms application demonstrating Semantic Kernel with Model Context Protocol (MCP). Provides tool functionality for GitHub, GitLab, and filesystem operations. Works with ChatGPT models. API key required.
About
What is WinFormsApp-MCP?
WinFormsApp-MCP is a Windows Forms application that demonstrates integrating large language models (LLMs) with Microsoft's Semantic Kernel framework using the Model Context Protocol (MCP). It is built for developers exploring how LLMs can interact with local and remote resources through tools like GitHub, GitLab, and filesystem operations, and it works with OpenAI ChatGPT models.
How to use WinFormsApp-MCP?
1. Clone the repository and open the solution in Visual Studio (requires .NET 8.0 or later).
2. Add an OpenAI API key via the Settings dialog or set the OpenAI__ApiKey environment variable; optionally set the OpenAI__ChatModelId environment variable (defaults to "gpt-4o-mini").
3. Configure MCP settings (GitLab integration, filesystem access controls) through the application’s settings interface.
4. Run the application to start interacting with the LLM using MCP tools.
Key features of WinFormsApp-MCP
- Integration with OpenAI (ChatGPT) models
- Tool functionality for GitHub and GitLab repository access
- Local filesystem operations via MCP
- Configurable settings for API key, model selection, and access controls
- Environment variable support for easy configuration
- Context-aware interactions between LLM and tools
Use cases of WinFormsApp-MCP
- Developers learning how to combine Semantic Kernel with MCP for tool-enabled LLM workflows
- Automating repository operations (e.g., reading files, listing issues) via natural language prompts
- Allowing an LLM to read, write, or analyze files on the local filesystem after user approval
- Experimenting with MCP tool implementations in a .NET desktop environment
FAQ from WinFormsApp-MCP
What API key is required to use WinFormsApp-MCP?
An OpenAI API key is required. You can provide it via the application’s Settings dialog or by setting the environment variable OpenAI__ApiKey.
Which .NET version is needed?
WinFormsApp-MCP requires .NET 8.0 or later.
Does WinFormsApp-MCP support models other than OpenAI?
No—the application only supports OpenAI (ChatGPT) models. The default model is "gpt-4o-mini" unless changed via the settings or the OpenAI__ChatModelId environment variable.
Is WinFormsApp-MCP open source?
The README does not specify a license; you must include your own license information when using or distributing the application.
Can I use WinFormsApp-MCP on platforms other than Windows?
No—because it is a Windows Forms application, it runs only on Windows.
Details
- Author
- robert-githubusername
- GitHub stars
- 3
- Category
- agent-framework
- Repository
- robert-githubusername/winformsapp-mcp
WinFormsApp-MCP
WinFormsApp-MCP is a Windows Forms application demonstrating Semantic Kernel with Model Context Protocol (MCP). It provides tool functionality for GitHub, GitLab, and filesystem operations, and works with ChatGPT models.
Overview
This application showcases the integration of large language models (LLMs) with Microsoft's Semantic Kernel framework, allowing models to interact with local and remote resources through the Model Context Protocol (MCP).
The implementation is based on the step-by-step guide from the Microsoft Semantic Kernel blog.

Features
- LLM Support:
- OpenAI (ChatGPT) models
- Tool Functionality:
- GitLab repository access
- GitHub repository access
- Filesystem operations
- Context-aware interactions
Requirements
- .NET 8.0 or later
- API key for OpenAI
Configuration
The application provides a settings interface to configure:
- API key
- Model selection
- GitLab integration settings
- Filesystem access controls
You can also configure the application using environment variables:
string? apiKey = Environment.GetEnvironmentVariable("OpenAI__ApiKey");
string? modelId = Environment.GetEnvironmentVariable("OpenAI__ChatModelId") ?? "gpt-4o-mini";
The application will check for these environment variables:
- OpenAI__ApiKey: Your OpenAI API key
- OpenAI__ChatModelId: The model to use (defaults to "gpt-4o-mini" if not specified)
Getting Started
1. Clone the repository
2. Open the solution in Visual Studio
3. Add your API key in the Settings dialog or set it as an environment variable
4. Configure MCP settings as needed
5. Run the application
MCP Resources
- Anthropic MCP Announcement - Original introduction of the Model Context Protocol
- MCP Servers Directory - Directory of available MCP servers
- Model Context Protocol Documentation - Official MCP documentation
- mcpdotnet NuGet Package - .NET library for Model Context Protocol
- Semantic Kernel Documentation
- Semantic Kernel GitHub Repository
- Integrating MCP Tools with Semantic Kernel Guide
License
[Include your license information here]