Dart MCP 서버
AI 기반 개발을 위한 Dart SDK 명령을 제공하는 배포 가능한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 모델 컨텍스트 프로토콜(MCP)을 구현하여 AI 코딩 어시스턴트와 Dart/Flutter 개발 워크플로 간의 격차를 해소합니다.
특징
이 MCP 서버는 다음 Dart SDK 명령에 대한 원활한 액세스를 제공합니다.
명령 | 설명 |
dart-analyze
| 오류, 경고 및 린트에 대한 Dart 코드 분석 |
dart-compile
| Dart를 다양한 형식(exe, AOT/JIT 스냅샷, JavaScript)으로 컴파일합니다. |
dart-create
| 템플릿에서 새로운 Dart 프로젝트 만들기 |
dart-doc
| Dart 프로젝트에 대한 API 문서 생성 |
dart-fix
| Dart 소스 코드에 자동 수정 적용 |
dart-format
| 스타일 가이드라인에 따라 Dart 소스 코드 형식 지정 |
dart-info
| 설치된 Dart 툴링에 대한 진단 정보 표시 |
dart-package
| 패키지 작업(get, add, upgrade, outdated 등) |
dart-run
| 인수 전달을 지원하는 Dart 프로그램 실행 |
dart-test
| 필터링 및 보고 옵션을 지원하여 테스트 실행 |
주요 이점
지능형 경로 처리 : 상대 경로를 절대 경로로 자동 변환하여 작업 디렉토리에 관계없이 명령이 올바르게 작동하도록 보장합니다.
프로젝트 자동 감지 : 홈 디렉토리 및 작업 공간과 같은 일반적인 위치에서 Dart/Flutter 프로젝트를 식별합니다.
크로스 플랫폼 지원 : macOS, Linux 및 Windows에서 작동
제로 구성 : 합리적인 기본값으로 바로 작동합니다.
MCP 통합 : Windsurf, Cline 및 기타 모델 컨텍스트 프로토콜 구현을 포함한 모든 MCP 클라이언트와 호환 가능
필수 조건
설치
Smithery를 통해 설치
Smithery 를 통해 Claude Desktop에 Dart MCP 서버를 자동으로 설치하려면:
지엑스피1
npx 사용(권장)
npx를 사용하면 설치 없이 서버를 직접 실행할 수 있습니다.
npx @egyleader/dart-mcp-server
글로벌 설치
더 쉽게 접근하려면 서버를 전역으로 설치할 수 있습니다.
npm install -g @egyleader/dart-mcp-server
그런 다음 다음을 사용하여 실행합니다.
출처에서
# Clone the repository
git clone https://github.com/egyleader/dart-mcp-server.git
cd dart-mcp-server
# Install dependencies
npm install
# Build the project
npm run build
# Run the server
node dist/index.js
MCP 클라이언트와의 통합
Windsurf / Codeium IDE 구성
Windsurf 또는 Codeium IDE와 함께 이 MCP 서버를 사용하려면 다음을 mcp_config.json 파일(일반적으로 ~/.codeium/windsurf/mcp_config.json 에 위치)에 추가하세요.
{
"mcpServers": {
"dart": {
"command": "npx",
"args": [
"-y",
"@egyleader/dart-mcp-server"
]
}
}
}
환경 변수
MCP 도구 사용 예
다음은 서버에서 제공하는 MCP 도구를 사용하는 방법의 예입니다. 이 예에서는 각 도구에 전달될 수 있는 매개변수를 보여줍니다.
다트 분석
Dart 코드에서 오류, 경고 및 린트를 분석합니다.
{
"path": "lib/main.dart",
"options": ["--fatal-infos", "--fatal-warnings"]
}
다트 컴파일
Dart 코드를 다양한 형식으로 컴파일합니다.
{
"path": "lib/main.dart",
"format": "exe",
"output": "build/app",
"options": ["--verbose"]
}
지원되는 형식: exe , aot-snapshot , jit-snapshot , kernel , js
다트 만들기
템플릿에서 새로운 Dart 프로젝트를 만듭니다.
{
"projectName": "my_awesome_app",
"template": "console",
"output": "projects/my_awesome_app",
"options": ["--force"]
}
projectName 및 출력에 대한 참고사항:
projectName 만 제공된 경우 프로젝트가 생성된 디렉토리 이름으로 사용됩니다.
output 제공되면 프로젝트가 생성된 디렉토리로 사용됩니다.
Dart의 실제 패키지/프로젝트 이름은 Dart CLI의 최종 디렉토리 이름에서 파생됩니다.
지원되는 템플릿: console , package , server-shelf , web
다트-닥
Dart 프로젝트에 대한 API 문서 생성:
{
"path": ".",
"output": "doc",
"options": ["--exclude", "lib/generated"]
}
다트-픽스
Dart 소스 코드에 자동화된 수정 사항을 적용합니다.
{
"path": "lib",
"apply": true,
"options": ["--pedantic"]
}
다트 포맷
스타일 가이드라인에 따라 Dart 소스 코드를 포맷하세요.
{
"paths": ["lib/main.dart", "lib/models"],
"setExitIfChanged": true,
"options": ["--line-length=100"]
}
다트 정보
설치된 Dart 툴링에 대한 진단 정보를 표시합니다.
{
"options": ["--verbose"]
}
다트 패키지
패키지 작업(pub 명령어):
{
"command": "get",
"workingDir": ".",
"args": ["--offline"]
}
지원되는 명령: get , upgrade , outdated , add , remove , publish , deps , downgrade , cache , run , global
다트 런
인수 전달을 지원하는 Dart 프로그램 실행:
{
"script": "bin/server.dart",
"workingDir": ".",
"args": ["--port=8080", "--mode=production"]
}
다트 테스트
필터링 및 보고 옵션을 지원하여 테스트를 실행합니다.
{
"path": "test",
"workingDir": ".",
"options": ["--name=login", "--platform=chrome"]
}
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
기여하다
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.
도구 API 참조
다트 분석
디렉토리나 파일에 있는 Dart 코드를 분석합니다.
{
path?: string; // Directory or file to analyze
options?: string[]; // Additional options for the dart analyze command
}
예:
{
path: "lib",
options: ["--fatal-infos", "--fatal-warnings"]
}
다트 컴파일
Dart를 다양한 형식으로 컴파일합니다.
{
format: 'exe' | 'aot-snapshot' | 'jit-snapshot' | 'kernel' | 'js'; // Output format
path: string; // Path to the Dart file to compile
output?: string; // Output file path
options?: string[]; // Additional compilation options
}
예:
{
format: "exe",
path: "bin/main.dart",
output: "bin/app"
}
다트 만들기
새로운 Dart 프로젝트를 만듭니다.
{
template: 'console' | 'package' | 'server-shelf' | 'web'; // Project template
projectName: string; // Name of the project to create
output?: string; // Directory where to create the project
options?: string[]; // Additional project creation options
}
메모:
output 제공되면 프로젝트가 해당 디렉토리에 생성됩니다.
projectName 만 제공된 경우 디렉토리 이름으로 사용됩니다.
실제 Dart 패키지 이름은 최종 디렉토리 이름에서 파생됩니다.
예:
{
template: "package",
projectName: "my_dart_library",
output: "projects/my_dart_library"
}
다트-닥
Dart 프로젝트에 대한 API 문서를 생성합니다.
{
path?: string; // Directory containing the Dart package to document
output?: string; // Output directory for the generated documentation
options?: string[]; // Additional documentation options
}
예:
{
path: ".",
output: "doc/api"
}
다트-픽스
Dart 소스 코드에 자동화된 수정 사항을 적용합니다.
{
path?: string; // Directory or file to apply fixes to
apply?: boolean; // Whether to apply the suggested fixes (default: true)
options?: string[]; // Additional fix options
}
예:
{
path: "lib",
apply: true,
options: ["--pedantic"]
}
다트 포맷
관용적으로 Dart 소스 코드를 형식화합니다.
{
paths: string[]; // Files or directories to format
setExitIfChanged?: boolean; // Return exit code 1 if there are formatting changes (default: false)
options?: string[]; // Additional format options
}
예:
{
paths: ["lib", "test"],
setExitIfChanged: true,
options: ["--line-length=80"]
}
다트 정보
설치된 도구에 대한 진단 정보를 표시합니다.
{
options?: string[]; // Additional info options
}
예:
{
options: ["--verbose"]
}
다트 패키지
패키지(pub 명령어)를 사용하여 작업합니다.
{
command: 'get' | 'upgrade' | 'outdated' | 'add' | 'remove' | 'publish' | 'deps' | 'downgrade' | 'cache' | 'run' | 'global'; // Pub subcommand
args?: string[]; // Arguments for the pub subcommand
workingDir?: string; // Working directory for the command
}
예:
// Add a package
{
command: "add",
args: ["rxdart"],
workingDir: "my_project"
}
// Get dependencies
{
command: "get",
workingDir: "my_project"
}
다트 런
Dart 프로그램을 실행합니다.
{
script: string; // Path to the Dart script to run
args?: string[]; // Arguments to pass to the script
workingDir?: string; // Working directory for the command
}
예:
{
script: "bin/main.dart",
args: ["--verbose"],
workingDir: "my_project"
}
다트 테스트
프로젝트에 대한 테스트를 실행합니다.
{
path?: string; // Path to the test file or directory
options?: string[]; // Additional test options
workingDir?: string; // Working directory for the command
}
예:
{
path: "test",
options: ["--coverage", "--name=auth"],
workingDir: "my_project"
}
개발
# Watch mode for development
pnpm run dev
# Build for production
pnpm run build
오류 처리
서버는 포괄적인 오류 처리를 구현합니다.
기여하다
자세한 기여 지침은 CONTRIBUTING.md를 참조하세요.
우리의 커밋 형식은 다음과 같습니다.
<type>[optional scope]: [JIRA-123(optional)] <description>
예:
feat(tools): [DART-456] add support for dart test tags
특허
MIT