Add MCP (Model Context Protocol) configuration for GitHub API and .NET server integration

.gitignore

@@ -0,0 +1,27 @@
+# MCP logs
+logs/
+*.log
+
+# Build artifacts
+bin/
+obj/
+dist/
+
+# Dependencies
+node_modules/
+*.nuget.props
+*.nuget.targets
+
+# IDE files
+.vscode/
+.vs/
+*.swp
+*.swo
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Temporary files
+*.tmp
+*.temp

MCP-README.md

@@ -0,0 +1,143 @@
+# MCP (Model Context Protocol) Configuration
+
+This directory contains the MCP (Model Context Protocol) configuration for the RepoHelper module, enabling GitHub API access and .NET MCP server integration.
+
+## Configuration Files
+
+- `mcp-config.json` - Main MCP configuration file
+- `public/mcp-config.ps1` - PowerShell helper functions for MCP management
+
+## Setup Instructions
+
+### 1. Install Prerequisites
+
+- Node.js (for GitHub MCP server)
+- Docker (for .NET MCP server)
+- PowerShell 7+ (for RepoHelper module)
+
+### 2. Configure GitHub Personal Access Token
+
+```powershell
+# Import the RepoHelper module
+Import-Module ./RepoHelper.psd1
+
+# Set up MCP configuration with your GitHub token
+$token = Read-Host "Enter your GitHub Personal Access Token" -AsSecureString
+Set-MCPConfiguration -GitHubToken $token
+```
+
+### 3. Test Configuration
+
+```powershell
+# Test the MCP configuration
+Test-MCPConfiguration
+
+# View current configuration
+Get-MCPConfiguration
+```
+
+### 4. Start MCP Servers
+
+```powershell
+# Start all MCP servers
+Start-MCPServers
+
+# Start specific server
+Start-MCPServers -ServerName "github"
+```
+
+## GitHub Personal Access Token Requirements
+
+Your GitHub Personal Access Token needs the following permissions:
+
+- `repo` - Full repository access
+- `read:org` - Read organization membership
+- `read:user` - Read user profile information
+- `read:project` - Read project information
+
+## MCP Server Configuration
+
+### GitHub Server
+
+The GitHub MCP server provides:
+- Repository management tools
+- Issue and pull request access
+- Organization and user information
+- Repository properties and settings
+
+### .NET MCP Server
+
+The .NET MCP server runs in a Docker container and provides:
+- Extended functionality for repository operations
+- Custom tools and resources
+- Integration with .NET ecosystem
+
+## Troubleshooting
+
+### Common Issues
+
+1. **GitHub Token Not Set**
+   ```
+   Error: GitHub Personal Access Token not configured
+   ```
+   Solution: Use `Set-MCPConfiguration` to set your token
+
+2. **Docker Not Available**
+   ```
+   Warning: Docker is not available. .NET MCP server will not work.
+   ```
+   Solution: Install Docker and ensure it's running
+
+3. **Node.js Not Found**
+   ```
+   Error: npx command not found
+   ```
+   Solution: Install Node.js and npm
+
+### Logging
+
+MCP server logs are stored in `./logs/mcp.log` by default. You can check this file for detailed error information.
+
+## Security Notes
+
+- The GitHub Personal Access Token is stored as an environment variable for the current session only
+- Never commit your actual token to version control
+- Use secure methods to store and retrieve your token
+- Consider using GitHub Apps for production deployments
+
+## Configuration Schema
+
+The `mcp-config.json` file follows this schema:
+
+```json
+{
+  "mcpServers": {
+    "server-name": {
+      "command": "executable-command",
+      "args": ["array", "of", "arguments"],
+      "env": {
+        "ENV_VAR": "value"
+      },
+      "description": "Server description",
+      "capabilities": ["tools", "resources", "prompts"]
+    }
+  },
+  "defaults": {
+    "timeout": 30000,
+    "maxRetries": 3
+  },
+  "logging": {
+    "level": "info",
+    "file": "./logs/mcp.log"
+  }
+}
+```
+
+## Contributing
+
+When adding new MCP servers:
+
+1. Add the server configuration to `mcp-config.json`
+2. Update the PowerShell helper functions in `public/mcp-config.ps1`
+3. Add tests for the new functionality
+4. Update this documentation

Test/public/mcp-config.test.ps1

@@ -0,0 +1,72 @@
+BeforeAll {
+    # Import the MCP functions directly since the module has dependency issues
+    . "$PSScriptRoot/../../public/mcp-config.ps1"
+}
+
+Describe "MCP Configuration Tests" {
+    Context "MCP Configuration File" {
+        It "Should exist" {
+            $configPath = Join-Path $PSScriptRoot "../../mcp-config.json"
+            Test-Path $configPath | Should -Be $true
+        }
+
+        It "Should be valid JSON" {
+            $configPath = Join-Path $PSScriptRoot "../../mcp-config.json"
+            $config = Get-Content $configPath -Raw | ConvertFrom-Json
+            $config | Should -Not -BeNullOrEmpty
+        }
+
+        It "Should have mcpServers section" {
+            $configPath = Join-Path $PSScriptRoot "../../mcp-config.json"
+            $config = Get-Content $configPath -Raw | ConvertFrom-Json
+            $config.mcpServers | Should -Not -BeNullOrEmpty
+        }
+
+        It "Should have github server configuration" {
+            $configPath = Join-Path $PSScriptRoot "../../mcp-config.json"
+            $config = Get-Content $configPath -Raw | ConvertFrom-Json
+            $config.mcpServers.github | Should -Not -BeNullOrEmpty
+            $config.mcpServers.github.command | Should -Be "npx"
+        }
+
+        It "Should have dotnet-mcp server configuration" {
+            $configPath = Join-Path $PSScriptRoot "../../mcp-config.json"
+            $config = Get-Content $configPath -Raw | ConvertFrom-Json
+            $config.mcpServers.'dotnet-mcp' | Should -Not -BeNullOrEmpty
+            $config.mcpServers.'dotnet-mcp'.command | Should -Be "docker"
+        }
+    }
+
+    Context "MCP Helper Functions" {
+        It "Get-MCPConfiguration should work" {
+            $config = Get-MCPConfiguration
+            $config | Should -Not -BeNullOrEmpty
+            $config.mcpServers | Should -Not -BeNullOrEmpty
+        }
+
+        It "Test-MCPConfiguration should validate config" {
+            $result = Test-MCPConfiguration
+            $result | Should -Be $true
+        }
+
+        It "Set-MCPConfiguration should accept SecureString token" {
+            $token = ConvertTo-SecureString "test-token" -AsPlainText -Force
+            { Set-MCPConfiguration -GitHubToken $token } | Should -Not -Throw
+        }
+    }
+
+    Context "Environment Variables" {
+        It "Should handle GitHub token environment variable" {
+            $token = ConvertTo-SecureString "test-token-12345" -AsPlainText -Force
+            Set-MCPConfiguration -GitHubToken $token
+
+            $envToken = [Environment]::GetEnvironmentVariable("GITHUB_PERSONAL_ACCESS_TOKEN")
+            $envToken | Should -Be "test-token-12345"
+        }
+    }
+}
+
+AfterAll {
+    # Clean up environment variables
+    [Environment]::SetEnvironmentVariable("GITHUB_PERSONAL_ACCESS_TOKEN", $null, "Process")
+}

examples/mcp-usage-example.ps1

@@ -0,0 +1,46 @@
+# MCP Configuration Usage Example
+# This script demonstrates how to use the MCP configuration with RepoHelper
+
+# Import the MCP functions
+. ./public/mcp-config.ps1
+
+# Example 1: Basic setup with GitHub token
+Write-Host "=== MCP Configuration Example ===" -ForegroundColor Green
+
+# Prompt for GitHub token (in real usage)
+Write-Host "Example: Setting up GitHub token..." -ForegroundColor Yellow
+$exampleToken = ConvertTo-SecureString "ghp_example_token_12345" -AsPlainText -Force
+Set-MCPConfiguration -GitHubToken $exampleToken -InformationAction Continue
+
+# Test the configuration
+Write-Host "`nTesting configuration..." -ForegroundColor Yellow
+$testResult = Test-MCPConfiguration -InformationAction Continue
+Write-Host "Configuration test result: $testResult" -ForegroundColor Cyan
+
+# View the configuration
+Write-Host "`nCurrent MCP Configuration:" -ForegroundColor Yellow
+$config = Get-MCPConfiguration
+$serverNames = $config.mcpServers.PSObject.Properties.Name
+Write-Host "Found $($serverNames.Count) MCP servers:" -ForegroundColor Cyan
+foreach ($serverName in $serverNames) {
+    $server = $config.mcpServers.$serverName
+    Write-Host "  - ${serverName}: $($server.command)" -ForegroundColor White
+}
+
+# Example 2: Check environment variables
+Write-Host "`nEnvironment Variables:" -ForegroundColor Yellow
+$githubToken = [Environment]::GetEnvironmentVariable("GITHUB_PERSONAL_ACCESS_TOKEN")
+if ($githubToken) {
+    Write-Host "GitHub token is configured (length: $($githubToken.Length))" -ForegroundColor Green
+} else {
+    Write-Host "GitHub token is not configured" -ForegroundColor Red
+}
+
+# Example 3: Start specific server (demonstration)
+Write-Host "`nStarting MCP servers (demonstration)..." -ForegroundColor Yellow
+Start-MCPServers -ServerName "github" -InformationAction Continue -WhatIf
+
+# Clean up (in real usage, you might want to keep the token)
+Write-Host "`nCleaning up..." -ForegroundColor Yellow
+[Environment]::SetEnvironmentVariable("GITHUB_PERSONAL_ACCESS_TOKEN", $null, "Process")
+Write-Host "Example completed." -ForegroundColor Green

mcp-config.json

@@ -0,0 +1,54 @@
+{
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": [
+        "@modelcontextprotocol/server-github"
+      ],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
+      },
+      "description": "GitHub API access via MCP server for repository management",
+      "capabilities": [
+        "tools",
+        "resources"
+      ]
+    },
+    "dotnet-mcp": {
+      "command": "docker",
+      "args": [
+        "run",
+        "--rm",
+        "-i",
+        "--name",
+        "dotnet-mcp-server",
+        "-p",
+        "3001:3001",
+        "-e",
+        "DOTNET_ENVIRONMENT=Development",
+        "-e",
+        "MCP_PORT=3001",
+        "-e",
+        "GITHUB_PERSONAL_ACCESS_TOKEN=${GITHUB_PERSONAL_ACCESS_TOKEN}",
+        "mcr.microsoft.com/dotnet/aspnet:8.0",
+        "sh",
+        "-c",
+        "dotnet new webapi -n MCPServer --no-restore && cd MCPServer && echo 'using Microsoft.AspNetCore.Mvc; [ApiController] [Route(\"api/[controller]\")] public class MCPController : ControllerBase { [HttpGet(\"health\")] public IActionResult Health() => Ok(new { status = \"healthy\", timestamp = DateTime.UtcNow }); [HttpPost(\"process\")] public IActionResult Process([FromBody] object request) => Ok(new { result = \"processed\", request }); }' > Controllers/MCPController.cs && dotnet run --urls=http://0.0.0.0:3001"
+      ],
+      "description": ".NET MCP server running in Docker container for extended functionality",
+      "capabilities": [
+        "tools",
+        "resources",
+        "prompts"
+      ]
+    }
+  },
+  "defaults": {
+    "timeout": 30000,
+    "maxRetries": 3
+  },
+  "logging": {
+    "level": "info",
+    "file": "./logs/mcp.log"
+  }
+}