local-MCP-server-with-LLM
인터넷이 없는 현장에서 Visual Studio 2022 안에서 최소한의 Agent형 코딩 보조 기능을 제공하는 로컬 MCP 서버.
개요
- 목적: 오프라인 환경에서 로컬 LLM + 로컬 MCP 서버 + 현장 자료 캐시로 코딩 보조 대응력 확보
- 클라이언트: Visual Studio 2022 (17.14+) Agent mode / 오프라인 CLI (Direct REST)
- LLM 런타임: Ollama (
/api/chat 엔드포인트)
- 기본 모델: qwen2.5-coder:7b
- 접속 방식: SSE (VS 2022 Agent mode) 또는 Direct REST API (오프라인 CLI)
- 상태: 4개 도구 구현 (summarize·add_comments·refactor·fix) · VS 2022 연동 · CLI REST 검증 · VS 2022 확장(VSIX) v1.1 (테마·마크다운·동적도구·코드적용)
- 비목표: GitHub Copilot 대체
구성
| 구성요소 | 역할 |
|----------|------|
| MCP Server | VS 2022 SSE + CLI Direct REST 요청을 수신·응답 |
| Tool Registry | MCP 도구 등록·조회·실행 |
| LLM Connector | 로컬 LLM과의 통신 추상화 |
| Resource Cache | 현장 필수 자료(문서, 표준, 참조)의 로컬 조회 |
| Configuration | 서버·모델·도구·캐시 설정 중앙 관리 |
| VS Extension (VSIX) | VS 2022 Tool Window에서 코드 요약 UI 제공 |
요구사항
- Visual Studio 2022 17.14 이상
- .NET 9.0 SDK
- 로컬 LLM 엔드포인트 (권장: Ollama + Qwen 계열)
- 현장 자료 캐시 (사전 준비 필요)
빠른 시작
1. Ollama 실행
ollama serve
ollama pull qwen2.5-coder:7b
2. MCP 서버 실행
cd src/LocalMcpServer
dotnet run
서버가 http://localhost:5100 에서 시작된다.
3. VS 2022 연결 (온라인 환경)
솔루션 루트의 .vs/mcp.json 이 이미 설정되어 있다. VS 2022에서 솔루션을 열고 Agent mode 채팅에서 MCP 도구를 사용할 수 있다.
4. CLI 직접 호출 (오프라인 환경)
인터넷이 없는 환경에서는 VS 2022 Agent mode가 MCP 도구를 호출할 수 없다. 이 경우 Direct REST API를 통해 CLI에서 직접 호출한다.
도구 목록 조회:
curl http://localhost:5100/api/tools/list
도구 호출 (코드 요약 예시):
curl -X POST http://localhost:5100/api/tools/call \
-H "Content-Type: application/json" \
-d '{
"name": "summarize_current_code",
"arguments": {
"code": "public class Foo { public int Bar() { return 42; } }",
"language": "csharp"
}
}'
PowerShell 예시:
# 도구 목록
Invoke-RestMethod http://localhost:5100/api/tools/list
# 코드 요약
$body = @{
name = "summarize_current_code"
arguments = @{ code = (Get-Content D:\_Github_LLM\local-MCP-server-with-LLM\src\LocalMcpServer\LlmConnector\LlmModels.cs -Raw); language = "csharp" }
} | ConvertTo-Json
Invoke-RestMethod http://localhost:5100/api/tools/call -Method POST `
-ContentType "application/json" -Body ([System.Text.Encoding]::UTF8.GetBytes($body))
현재 지원 도구
| 도구 | 설명 | 상태 |
|------|------|------|
| summarize_current_code | 코드 텍스트를 받아 한국어로 구조화된 요약 | ✅ 구현 완료 |
| add_comments | 코드에 문서 주석(XML doc, JSDoc 등) + 인라인 주석 자동 추가 | ✅ 구현 완료 |
| refactor_current_code | 가독성·구조·현대적 표현 기반 코드 리팩터링 | ✅ 구현 완료 |
| fix_code_issues | 버그·안티패턴·보안 취약점 탐지 및 수정 | ✅ 구현 완료 |
| search_project_code | 프로젝트 내 코드 검색 | 🔲 미구현 |
| suggest_fix_from_error_log | 에러 로그 기반 수정 제안 | 🔲 미구현 |
| ask_local_docs | 현장 문서 질의응답 | 🔲 미구현 |
VS 2022 MCP 연결 설정 (SSE)
인터넷이 필요한 온라인 환경에서 VS 2022 Agent mode를 통해 MCP 도구를 사용하는 방법이다.
오프라인 환경에서는 위의 "CLI 직접 호출" 섹션을 참고한다.
방법 1: 솔루션별 설정 (권장)
솔루션 루트에 .vs/mcp.json 파일을 생성한다:
{
"servers": {
"local-mcp": {
"type": "sse",
"url": "http://localhost:5100/sse"
}
}
}
type: 전송 방식 ("sse" 또는 "stdio")url: MCP 서버 엔드포인트 URL (SSE 방식인 경우).vs/mcp.json은 솔루션을 여는 모든 사용자에게 적용된다. Git에 포함하면 팀 공유 가능.
방법 2: VS 사용자 설정
- Tools → Options → GitHub Copilot → MCP Servers 로 이동
- Add Server 클릭
- 서버 이름, 전송 방식, URL을 입력
- 이 설정은 해당 VS 인스턴스의 모든 솔루션에 적용된다.
참고: Agent mode에서 MCP 도구를 사용하려면 채팅 창의 모드를 "Agent"로 전환해야 한다.
프로젝트 구조
src/LocalMcpServer/
.gitignore — Git 제외 설정 (bin/, obj/ 등)
Program.cs — 진입점, DI 구성, 서버 시작
Configuration/ServerConfig.cs — 설정 모델 (contracts.md §5)
LlmConnector/LlmModels.cs — LLM 요청/응답 모델 (contracts.md §3)
LlmConnector/OllamaConnector.cs — Ollama /api/chat 클라이언트
ToolRegistry/IMcpTool.cs — 도구 인터페이스
ToolRegistry/ToolRegistryService.cs — 도구 등록·조회
ToolRegistry/SummarizeCurrentCodeTool.cs — summarize_current_code 구현
ToolRegistry/CodeToolBase.cs — 코드 수정 도구 공통 추상 클래스
ToolRegis
... [View full README on GitHub](https://github.com/jcseo1028/local-MCP-server-with-LLM#readme)
