MCP 문제 해결사

MCP 문제 해결사 [작업 진행 중]

⚠️ 중요 : 이 패키지는 현재 개발 중이며 아직 정식 출시 준비가 되지 않았습니다. 현재 버전은 개발 중이므로 불완전한 기능이나 주요 변경 사항이 포함될 수 있습니다.

AI 모델이 MCP 관련 문제를 진단하고 해결할 수 있도록 하는 자체 진단 프레임워크입니다.

건축학

지엑스피1

개요

MCP 문제 해결사는 개발자만 할 수 있는 문제 해결 작업을 AI가 직접 활용할 수 있는 기능으로 전환해주는 전문화된 MCP 서버로, AI 모델이 다음과 같은 작업을 수행할 수 있도록 해줍니다.

MCP 로그 분석 - 일반적인 오류 패턴을 자동으로 스캔하고 통찰력 있는 진단을 제공합니다.
구성 검증 - 모범 사례에 맞춰 서버 구성을 확인하고 문제를 식별합니다.
연결 테스트 - 네트워크 연결 및 서버 가용성 확인
템플릿 생성 - 빠른 설정을 위한 작동 MCP 서버 구성 생성
일반적인 문제 해결 - 구성을 업데이트하고 솔루션을 직접 구현합니다.

설치

# Install the package globally
npm install -g @devlimelabs/mcp-troubleshooter

# Start the server
mcp-troubleshooter

용법

Claude Desktop 구성

Claude Desktop 구성에 다음을 추가하세요.

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

도구

로그 관리 도구

read-mcp-logs : MCP 로그 파일을 검색하고 표시합니다.
analyze-mcp-logs : 패턴 인식을 사용하여 일반적인 오류 시그니처를 식별합니다.

구성 도구

read-mcp-config : Claude Desktop의 MCP 구성을 추출하고 검증합니다.
update-mcp-config : 적절한 백업 메커니즘을 사용하여 구성을 안전하게 업데이트합니다.
validate-mcp-server-config : 서버 구성에 대한 심층적 검증을 수행합니다.

연결 테스트 도구

test-port-availability : MCP 서버에 필요한 포트가 사용 가능한지 확인합니다.
check-mcp-server-process : MCP 서버 프로세스가 올바르게 실행되고 있는지 확인합니다.

구현 도구 수정

generate-mcp-server-template : 다양한 언어에 대한 사용자 정의 서버 템플릿을 생성합니다.
generate-claude-desktop-config : Claude Desktop에 대한 최적화된 구성 파일을 빌드합니다.

자원

common-mcp-issues : 일반적인 MCP 문제와 해결 방법에 대한 포괄적인 가이드
mcp-config-templates : 다양한 MCP 서버 설정을 위한 구성 템플릿

예시 사용 사례

손상된 MCP 서버 진단

User: My MCP server isn't connecting properly to Claude Desktop. Can you help diagnose it?

Claude: I'll help diagnose your MCP server connection issue. First, let me run some diagnostics.

[Uses check-mcp-server-process tool with the command from the user]

I've identified several possible issues with your MCP server:

1. **Connection Timeout**: The server isn't responding within the expected timeframe.
2. **JSON-RPC Format Error**: There seems to be a format issue in the JSON-RPC responses.
3. **Transport Mismatch**: Claude Desktop is expecting stdio transport, but your server might be using SSE.

Let me run a more specific connection test to confirm:

[Uses test-port-availability tool]

The connection test confirms that your server is starting, but it's timing out during the handshake phase. This is likely due to incorrect JSON-RPC message formatting in your server implementation.

Recommended fixes:
1. Ensure your server returns properly formatted JSON-RPC 2.0 responses
2. Check your transport implementation, it should be using proper stdio pipes
3. Verify that your server is correctly handling the initialize method

Would you like me to analyze a specific log file or check your server's code for these issues?

MCP 구성 검증

User: Can you validate my Claude Desktop MCP configuration?

Claude: I'd be happy to validate your Claude Desktop MCP configuration.

[Uses read-mcp-config tool]

I've analyzed your Claude Desktop configuration file. Here are my findings:

✅ **Valid Configuration Structure**: The overall structure of your configuration is valid.

⚠️ **Path Issues**: 2 servers have invalid paths:
- "code-llm": The file path "/usr/local/bin/code-llm" doesn't exist
- "database-tool": The command "db-tool" is not in the PATH

❌ **Environment Variables**: 1 server has missing required environment variables:
- "firebase-mcp": Missing required FIREBASE_API_KEY

✅ **Transport Configuration**: All servers properly specify transport options

Recommended fixes:
1. Update the path for "code-llm" to the correct location
2. Install "db-tool" or correct its path
3. Add the missing FIREBASE_API_KEY to the "firebase-mcp" server configuration

Would you like me to help you implement any of these fixes?

플랫폼 지원

Windows : %APPDATA%\Claude\ 로그 �� 구성에 액세스합니다.
macOS : ~/Library/Logs/Claude/ 의 로그와 ~/Library/Application Support/Claude/ 구성에 액세스합니다.
Linux : ~/.local/share/Claude/logs/ 의 로그와 ~/.config/Claude/ 의 구성에 액세스합니다.

개발

# Clone the repository
git clone https://github.com/devlimelabs/master-mcps.git
cd master-mcps

# Install dependencies
pnpm install

# Build the package
pnpm -F @devlimelabs/mcp-troubleshooter build

# Run tests
pnpm -F @devlimelabs/mcp-troubleshooter test

특허

MIT

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

View all tools

로그 분석, 구성 검증, 연결 테스트, 솔루션 구현 등을 통해 AI 모델이 MCP 관련 문제를 스스로 진단하고 해결할 수 있도록 하는 특수 진단 프레임워크입니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Log Reader
klara-research
A
security
A
license
A
quality
A specialized MCP server that helps analyze and debug Model Context Protocol logs by providing Claude with direct access to log files across multiple platforms.
Last updated -
1
13
MIT License
MCPfinder Server
mcpfinder
A
security
A
license
A
quality
Enables AI assistants to discover, retrieve details about, and manage MCP (Model Context Protocol) servers that provide additional tools and capabilities on demand.
Last updated -
5
32
7
AGPL 3.0
Aibolit MCP Server
cqfn
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that helps AI coding assistants identify critical design issues in code, rather than just focusing on cosmetic problems when asked to improve code.
Last updated -
1
5
17
MIT License
Policy Troubleshooter API MCP Server
ag2-mcp-servers
-
security
F
license
-
quality
An MCP server that provides natural language interaction with Google's Policy Troubleshooter API, allowing users to troubleshoot access denied errors and analyze IAM policies.
Last updated -

View all related MCP servers

MCP Troubleshooter