ReflectionMcpServer 0.0.5

.NET Reflection MCP Server

.NET 어셈블리를 리플렉션으로 분석하는 MCP(Model Context Protocol) 서버입니다.

개요

이 MCP 서버는 .NET 어셈블리의 타입, 메서드, 프로퍼티 정보를 조회할 수 있는 도구를 제공합니다. Claude Desktop이나 다른 MCP 클라이언트와 함께 사용하여 .NET 어셈블리를 분석할 수 있습니다.

기능

1. get_method_signature - 메서드 시그니처 조회

특정 메서드의 시그니처, 파라미터, 반환 타입을 조회합니다.

파라미터:

• assembly_path (필수): .NET 어셈블리 파일 경로
• method_name (필수): 검색할 메서드 이름
• type_name (선택): 메서드를 포함하는 타입의 전체 이름

2. get_type_info - 타입 정보 조회

타입의 상세 정보(메서드, 프로퍼티, 인터페이스 등)를 조회합니다.

파라미터:

• assembly_path (필수): .NET 어셈블리 파일 경로
• type_name (필수): 검사할 타입의 전체 이름

3. list_types - 타입 목록 조회

어셈블리의 모든 타입을 나열합니다.

파라미터:

• assembly_path (필수): .NET 어셈블리 파일 경로
• filter (선택): 타입 이름 필터 (대소문자 구분 안함)

설치 및 사용

방법 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에서 다음과 같이 요청할 수 있습니다:

Proto.Actor.dll 어셈블리에서 SpawnNamed 메서드의 시그니처를 알려줘

Proto.IRootContext 타입의 정보를 보여줘

Proto.Actor.dll에서 RootContext를 포함하는 모든 타입을 나열해줘

기술 스택

• .NET 9.0
• ModelContextProtocol 0.4.0-preview.3
• 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