ReflectionMcpServer 0.1.3

C# Roslyn MCP Server

Roslyn (Microsoft.CodeAnalysis)을 사용하여 C# 소스 코드를 분석하는 MCP(Model Context Protocol) 서버입니다.

개요

이 MCP 서버는 Roslyn API를 직접 사용하여 C# 소스 코드를 분석하고 타입 정보, 심볼 정보, 코드 진단 등을 제공합니다. Claude Desktop이나 다른 MCP 클라이언트와 함께 사용할 수 있습니다.

기능

1. get_symbol_info - 심볼 정보 조회

C# 소스 파일에서 심볼(클래스, 메서드, 프로퍼티 등)의 상세 정보를 조회합니다.

파라미터:

• filePath (필수): C# 소스 파일 경로
• symbolName (필수): 검색할 심볼 이름

예제 출력:

╔═══ Method: Add
║ Full Name: TestApp.Calculator.Add(int, int)
║ Return Type: int
║ Parameters:
║   - int a
║   - int b
║ Documentation: [XML 문서 주석]
╚═══

2. get_type_info - 타입 정보 조회

타입의 상세 정보(메서드, 프로퍼티, 필드, 상속 관계 등)를 조회합니다.

파라미터:

• filePath (필수): C# 소스 파일 경로
• typeName (필수): 검색할 타입 이름 (부분 일치 지원)

3. list_types - 타입 목록 조회

C# 소스 파일에 정의된 모든 타입을 나열합니다.

파라미터:

• filePath (필수): C# 소스 파일 경로

4. analyze_code - 코드 분석

C# 코드의 구문 오류, 경고, 진단 정보를 분석합니다.

파라미터:

• filePath (필수): C# 소스 파일 경로

5. analyze_project - 프로젝트 분석

.csproj 파일을 기반으로 전체 프로젝트를 분석합니다. NuGet 패키지를 포함한 모든 참조를 로드하여 심볼 검색이 가능합니다.

파라미터:

• projectPath (필수): .csproj 파일 경로
• symbolName (선택): 검색할 심볼 이름

예제 출력:

Project: ReflectionMcp
Language: C#
Files: 3
References: 224

Referenced Assemblies:
  - Microsoft.CodeAnalysis.CSharp.dll
  - ModelContextProtocol.dll
  ...

6. find_nuget_symbol - NuGet 심볼 찾기

프로젝트가 참조하는 NuGet 패키지에서 타입이나 메서드를 찾습니다. 인터페이스, 클래스, 메서드 등 모든 종류의 심볼을 검색할 수 있습니다.

파라미터:

• projectPath (필수): .csproj 파일 경로
• symbolName (필수): 검색할 심볼 이름

예제 출력:

Assembly: Microsoft.Extensions.Hosting.Abstractions
────────────────────────────────────────────────────────────
  Interface: Microsoft.Extensions.Hosting.IHost
    Implements: System.IDisposable
  Interface: Microsoft.Extensions.Hosting.IHostBuilder
  ...

설치 및 사용

방법 1: dnx로 바로 실행 (.NET 10+)

.NET 10 이상에서는 dnx 명령어로 설치 없이 바로 실행할 수 있습니다:

dnx ReflectionMcpServer

또는 특정 버전을 지정:

dnx ReflectionMcpServer@1.0.0

방법 2: 전역 도구로 설치

dotnet tool install -g ReflectionMcpServer
reflection-mcp

방법 3: 로컬 빌드 및 실행

cd z:\2025\ReflectionMcpServer
dotnet build

Claude Desktop 설정

방법 1: dnx 사용 (.NET 10+)

{
  "mcpServers": {
    "reflection": {
      "command": "dnx",
      "args": ["ReflectionMcpServer", "--yes"]
    }
  }
}

방법 2: 전역 도구 사용

{
  "mcpServers": {
    "reflection": {
      "command": "reflection-mcp"
    }
  }
}

방법 3: 로컬 빌드 사용

Claude Desktop의 설정 파일에 다음을 추가하세요:

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "reflection": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "z:\\2025\\ReflectionMcpServer\\src\\ReflectionMcp.csproj"
      ]
    }
  }
}

또는 빌드된 바이너리를 직접 실행:

{
  "mcpServers": {
    "reflection": {
      "command": "z:\\2025\\ReflectionMcpServer\\src\\bin\\Debug\\net9.0\\ReflectionMcp.exe"
    }
  }
}

사용 예제

Claude Desktop에서 다음과 같이 요청할 수 있습니다:

Calculator.cs 파일에 있는 모든 타입을 나열해줘

Calculator 클래스의 상세 정보를 보여줘

Add 메서드의 정보를 알려줘

Calculator.cs 파일의 코드를 분석해서 오류와 경고를 찾아줘

테스트

테스트 프로그램으로 동작 확인:

cd test/TestRunner
dotnet run

기술 스택

• .NET 9.0
• ModelContextProtocol 0.4.0-preview.3
• Microsoft.CodeAnalysis.CSharp 4.11.0 (Roslyn)
• Microsoft.CodeAnalysis.CSharp.Workspaces 4.11.0
• stdio transport (표준 입출력 기반 통신)

라이선스

MIT

GitHub Packages 배포 방법

자동 배포

GitHub에서 Release를 생성하면 자동으로 GitHub Packages에 배포됩니다:

1. GitHub 저장소에서 Releases 클릭
2. Draft a new release 클릭
3. 태그 생성: v1.0.0 (버전 번호 입력)
4. Release 제목과 설명 작성
5. Publish release 클릭

Release가 publish되면 자동으로 GitHub Actions가 실행되어 패키지가 배포됩니다.

GitHub Packages에서 패키지 설치

# nuget.config에 GitHub Packages 소스 추가
dotnet nuget add source "https://nuget.pkg.github.com/seungyongshim/index.json" --name github --username USERNAME --password GITHUB_PAT

# 패키지 설치
dotnet add package ReflectionMcpServer

참고: GitHub PAT(Personal Access Token)이 필요합니다:

• Settings → Developer settings → Personal access tokens → Tokens (classic)
• read:packages 권한 필요

로컬에서 패키지 생성

cd src
dotnet pack --configuration Release --output ../artifacts