de en es ja ko ru zh

mcp-manager

Name: mcp-manager
Author: kobramantra-debug

by kobramantra-debug

Overview Schema Source Related Servers Discussions Admin

Python

Local

MCP Manager

License: MIT Python 3.10+

범용 MCP 서버 매니저 — 모든 MCP 서버를 한 곳에서 추가, 제거, 모니터링, 구성하세요.

빠른 시작

git clone https://github.com/kobramantra-debug/mcp-manager-mcp-manage.git
cd mcp-manager-mcp-manage
pip install -e .

Related MCP server: git-org-group-cred-vault

설치

소스에서

git clone https://github.com/kobramantra-debug/mcp-manager-mcp-manage.git
cd mcp-manager-mcp-manage
pip install -e .

Docker

docker build -t mcp-manager .

구성

환경 변수

변수	기본값	설명
`MCP_HARNESS`	`opencode`	관리할 활성 하네스
`MCP_CONFIG_PATH`	(자동 감지)	구성 파일 경로 재정의
`MCP_MANAGER_MASTER_PASSWORD`	(없음)	Fernet 암호화를 위한 마스터 비밀번호

OpenCode

다음에 추가: ~/.config/opencode/opencode.json:

{
  "mcp": {
    "mcp-manager": {
      "type": "local",
      "command": ["python", "-m", "src"],
      "cwd": "/path/to/mcp-manager",
      "enabled": true
    }
  }
}

Claude Desktop

다음에 추가: %APPDATA%/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-manager": {
      "command": "python",
      "args": ["-m", "src"],
      "cwd": "/path/to/mcp-manager"
    }
  }
}

Cursor

다음에 추가: ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mcp-manager": {
      "command": "python",
      "args": ["-m", "src"],
      "cwd": "/path/to/mcp-manager"
    }
  }
}

Docker (STDIO)

{
  "mcp": {
    "mcp-manager": {
      "type": "docker",
      "command": ["docker", "run", "-i", "--rm", "mcp-manager"],
      "enabled": true
    }
  }
}

예제

1. 모든 하네스를 나열하고 설치된 항목 확인

list_harnesses_info()

{
  "harnesses": [
    {"id": "opencode", "name": "OpenCode", "installed": true, "is_active": true},
    {"id": "claude-desktop", "name": "Claude Desktop", "installed": true, "is_active": false},
    {"id": "cursor", "name": "Cursor", "installed": false, "is_active": false},
    {"id": "windsurf", "name": "Windsurf", "installed": false, "is_active": false},
    {"id": "cline", "name": "Cline", "installed": false, "is_active": false},
    {"id": "zed", "name": "Zed", "installed": false, "is_active": false},
    {"id": "continue", "name": "Continue.dev", "installed": false, "is_active": false}
  ],
  "active": "opencode",
  "installed_count": 2
}

2. Claude Desktop으로 전환하고 서버 나열

switch_harness("claude-desktop")
list_servers()

{
  "harness": "Claude Desktop",
  "servers": [
    {"name": "github", "enabled": true, "type": "docker"},
    {"name": "playwright", "enabled": true, "type": "npx"}
  ],
  "count": 2
}

3. 카탈로그에서 GitHub MCP 서버 추가

add_from_catalog("github")

{
  "success": true,
  "action": "added",
  "server": "github",
  "harness": "OpenCode",
  "catalog_entry": "github",
  "config": {
    "type": "docker",
    "command": ["docker", "run", "-i", "--rm", "-e", "GITHUB_TOKEN={env:GITHUB_TOKEN}", "ghcr.io/github/github-mcp-server"],
    "enabled": true
  }
}

4. 사용자 지정 원격 서버 추가

add_server(
    name="my-api",
    server_type="remote",
    url="https://api.example.com/mcp",
    env_vars="API_KEY=sk-123,BASE_URL=https://api.example.com"
)

{
  "success": true,
  "action": "added",
  "server": "my-api",
  "config": {
    "type": "remote",
    "url": "https://api.example.com/mcp",
    "environment": {"API_KEY": "sk-123", "BASE_URL": "https://api.example.com"},
    "enabled": true
  }
}

5. 모든 서버에 대해 상태 점검 실행

health_check()

{
  "harness": "opencode",
  "summary": {"total": 3, "healthy": 2, "unhealthy": 1, "unknown": 0, "timeout": 0},
  "results": {
    "github": {"status": "healthy", "message": "Server: github-mcp-server", "latency_ms": 1250.3},
    "playwright": {"status": "healthy", "message": "Server: playwright", "latency_ms": 890.1},
    "my-api": {"status": "unhealthy", "message": "No response (exit 1)", "latency_ms": 5000.0}
  }
}

6. OpenCode에서 Cursor로 모든 서버 동기화

sync_to_harness("cursor")

{
  "success": true,
  "source": "OpenCode",
  "target": "Cursor",
  "servers_synced": 3,
  "added": 3,
  "updated": 0
}

7. 만료 토큰 교체

rotate_token("github", "ghp_new_token_abc123", expires_at="2026-12-31")

{
  "success": true,
  "action": "token_rotated",
  "server": "github",
  "preview": "ghp_***abc123",
  "expires_at": "2026-12-31"
}

8. 서버 카탈로그 검색

search_catalog("database")

{
  "results": [
    {"id": "postgres", "name": "PostgreSQL", "description": "PostgreSQL database server", "category": "database"},
    {"id": "sqlite", "name": "SQLite", "description": "SQLite database server", "category": "database"}
  ],
  "count": 2
}

9. 다른 하네스용 구성 내보내기

export_for_harness("claude-desktop")

{
  "source_harness": "opencode",
  "target_harness": "claude-desktop",
  "config": {
    "mcpServers": {
      "github": {"command": "docker", "args": ["run", "-i", "--rm", "ghcr.io/github/github-mcp-server"]},
      "playwright": {"command": "npx", "args": ["-y", "@anthropic/playwright-mcp"]}
    }
  },
  "note": "Import this JSON into Claude Desktop"
}

10. 저장된 모든 토큰 나열 (안전 — 미리보기만)

list_all_tokens()

{
  "tokens": {
    "github": {"token_preview": "ghp_***abc123", "storage_backend": "encrypted_sqlite"},
    "supabase": {"token_preview": "sb-***xyz789", "storage_backend": "encrypted_sqlite"}
  },
  "count": 2
}

도구 참조

하네스 관리

도구	설명
`list_harnesses_info`	모든 하네스 및 설치 상태 나열
`switch_harness`	활성 하네스 전환
`get_active_harness`	현재 하네스 정보 가져오기

서버 관리

도구	설명
`list_servers`	구성된 서버 나열
`add_server`	새 서버 추가
`remove_server`	서버 제거
`get_server_detail`	서버 세부 정보 가져오기
`enable_server`	비활성화된 서버 활성화
`disable_server`	서버 비활성화

상태 및 모니터링

도구	설명
`test_connection`	단일 서버 테스트
`health_check`	모든 서버 테스트
`get_logs`	상태 점검 기록 가져오기

토큰 관리

도구	설명
`rotate_token`	API 토큰 업데이트
`retrieve_token`	복호화된 토큰 가져오기 (주의해서 사용)
`list_all_tokens`	저장된 토큰 나열 (미리보기만)
`get_token_history`	교체 기록 가져오기
`list_token_backends`	암호화 상태 표시

내보내기 / 가져오기 / 동기화

도구	설명
`export_config`	구성을 JSON으로 내보내기
`import_config`	JSON에서 구성 가져오기
`export_for_harness`	다른 하네스 형식으로 내보내기
`sync_to_harness`	다른 하네스로 서버 동기화

카탈로그

도구	설명
`search_catalog`	서버 카탈로그 검색
`add_from_catalog`	카탈로그에서 서버 추가

지원되는 하네스

하네스	구성 경로	형식
OpenCode	`~/.config/opencode/opencode.json`	`mcp` (키 기반 객체)
Claude Desktop	`%APPDATA%/Claude/claude_desktop_config.json`	`mcpServers` (키 기반 객체)
Cursor	`~/.cursor/mcp.json`	`mcpServers` (키 기반 객체)
Windsurf	`~/.codeium/windsurf/mcp_config.json`	`mcpServers` (키 기반 객체)
Cline	`%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`	`mcpServers` (키 기반 객체)
Zed	`%APPDATA%/Zed/settings.json`	`context_servers` (중첩 객체)
Continue.dev	`~/.continue/config.json`	`mcpServers` (배열)

서버 카탈로그

서버	유형	설명
github	docker	GitHub MCP 서버
supabase	npx	Supabase MCP 서버
playwright	npx	Playwright 브라우저 자동화
chrome-devtools	npx	Chrome DevTools 프로토콜
context7	npx	Context7 문서 조회
filesystem	local	파일 시스템 접근
git	local	Git 작업
postgres	npx	PostgreSQL 데이터베이스
sqlite	npx	SQLite 데이터베이스
docker	local	Docker 관리
brave-search	npx	Brave Search API
fetch	npx	HTTP fetch 도구
memory	local	지식 그래프 메모리
slack	npx	Slack 워크스페이스 통합
gdrive	npx	Google Drive 접근
google-maps	npx	Google Maps API
puppeteer	npx	Puppeteer 브라우저 자동화
everything	npx	유니버설 검색
stitch	npx	Stitch UI 디자인

토큰 보안

토큰은 Fernet (AES-128-CBC)을 사용하여 암호화된 SQLite 데이터베이스에 저장됩니다.

암호화를 활성화하려면 MCP_MANAGER_MASTER_PASSWORD를 설정하세요:

# Linux/macOS
export MCP_MANAGER_MASTER_PASSWORD="your-secure-password"

# Windows
set MCP_MANAGER_MASTER_PASSWORD=your-secure-password

마스터 비밀번호가 없으면 토큰이 평문으로 저장됩니다 (프로덕션에는 권장되지 않음).

라이선스

MIT 라이선스 — 자세한 내용은 LICENSE를 참조하세요.

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityNo data

ResponsivenessSyncing

Resources

Related MCP Connectors

Speakeasy Platform MCP
com.speakeasy.ai
Secure and manage MCP servers through the Speakeasy AI Control Plane from your agent.
Developer Tools Security Agent Orchestration
1276
https://ai.speakeasy.com/platform-mcp
Flowra
io.github.flowradev
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Agent Orchestration Autonomous Agents
11
https://mcp.flowra.dev/mcp
Meandr
com.meandr
MCP gateway and cloud hosting for MCP servers, agents and apps like RAG, managed from your agent.
Agent Orchestration Autonomous Agents Security
1
https://mcp.meandr.com
H-Index A
ai.xr-utilities
Capability registry for the agentic economy. Semantic search over verified MCP server listings.
Search Documentation Access
2
https://h-index.xr-utilities.ai/mcp

Related MCP Servers

mcp-ssh-multi
Shell Access File Systems
gilberth
A
license
A
quality
C
maintenance
MCP server for managing multiple SSH servers via AI assistants, offering tools for remote command execution, file operations, and system monitoring.
Updated 3 months ago (2026-08-11 04:45 UTC)
11
45 PyPI
2
MIT
git-org-group-cred-vault
Version Control Security Developer Tools
wildfirebill-ai
A
license
Not graded
quality
D
maintenance
MCP server for securely managing GitHub & GitLab credentials in an encrypted vault, allowing AI agents to retrieve tokens by org or group name automatically.
Updated 3 months ago (2026-08-11 16:02 UTC)
MIT
SuperGateway Pro
AI & Machine Learning Autonomous Agents Monitoring
odhomane
A
license
Not graded
quality
C
maintenance
Enables centralized MCP server management with connection pooling, a live activity dashboard, and macOS menu bar integration for AI coding agents.
Updated 2 months ago (2026-08-22 11:34 UTC)
MIT
Magg
Autonomous Agents Developer Tools
FlorianDeluca492
F
license
Not graded
quality
A
maintenance
Enables LLMs to manage, aggregate, and proxy other MCP servers dynamically, including discovering, adding, enabling, disabling, and configuring servers while exposing their tools under unified prefixes.
Updated 20 days ago (2026-10-17 05:49 UTC)
-