
kkokosa/repl-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
모형 Context 의정서 (MCP) 서버를 위한 상호 작용하는 REPL
개요
모형 Context 의정서 (MCP) 서버를 위한 상호 작용하는 REPL. Replated 블로그 게시물: https://kokosa.dev/blog/2026/repl-mcp/. - 목록 및 검사 도구, 프롬프트, 및 리소스 - JSON 또는 인터랙티브 매개 변수 입력이있는 도구 - 명령 및 도구 이름을위한 탭 autocompletion - 명령 기록 ( 화살표 키) - 구문 강조와 리치 터미널 UI mcp-remote sidenote - 일부 MCP 서버 ( Atlassian과 같은) 인증을위한 OAuth를 사용하고 직접 HTTP 연결을 지원하지 않습니다. mcp-remote MCP는 OAuth를 처리하여이 간격을 로컬로 변환하고 / 또는 HTTP 기반 MCP 서버를 stdio 수송으로 변환합니다. OAuth 기반 서버의 경우, OAuth 콜백을 수신하는 mcp-remote 필요. 공공 URL (WSL 또는 원격 서버와 같은)없이 환경에서 실행되는 경우, ngrok과 같은 터널링 도구가 콜백 엔드 포인트를 노출해야합니다. - Python 3.10+ - Node.js (npx mcp-remote를 사용하는 경우)
개요(AI 번역)
모형 Context 의정서 (MCP) 서버를 위한 상호 작용하는 REPL.
Replated 블로그 게시물: https://kokosa.dev/blog/2026/repl-mcp/.
특징
- 도구, 프롬프트 및 리소스 목록 및 검사
- JSON 또는 Interactive 매개 변수 입력을 가진 호출 도구
- 명령 및 도구 이름에 대한 탭 autocompletion
- 명령 역사 (arrow key)
- syntax 강조 표시를 가진 부유한 끝 UI
설치
옵션 1: PyPI에서 설치 (추천)
옵션 2 : 설치하지 않고 직접 실행
옵션 3: 개발 설정
사용법
[!노트]
mcp-remotesidenote - 일부 MCP 서버 ( Atlassian과 같은) 인증을위한 OAuth를 사용하고 직접 HTTP 연결을 지원하지 않습니다.mcp-remoteMCP는 로컬 및/또는 HTTP 기반 MCP 서버를 변환하여 OAuth를 처리함으로써이 격차를 브릿지합니다. OAuth 기반 서버의 경우,mcp-remote]는 OAuth 콜백을 수신해야합니다. 공공 URL (WSL 또는 원격 서버와 같은)없이 환경에서 실행되는 경우, ngrok과 같은 터널링 도구가 콜백 엔드 포인트를 노출해야합니다.
Stdio Transport (인기 기반)
HTTP 전송 (URL 기반)
config 파일 사용
Config 파일 형식
** 교통 : **
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
MCP REPL
Interactive REPL for testing Model Context Protocol (MCP) servers.
Replated blog post: https://kokosa.dev/blog/2026/repl-mcp/.
Features
- List and inspect tools, prompts, and resources
- Call tools with JSON or interactive parameter input
- Tab autocompletion for commands and tool names
- Command history (arrow keys)
- Rich terminal UI with syntax highlighting
Installation
Option 1: Install from PyPI (Recommended)
# Using uv (fast, Rust-based)
uv tool install repl-mcp
# Using pipx
pipx install repl-mcp
# Using pip
pip install repl-mcp
Option 2: Run directly without installing
# Using uvx
uvx repl-mcp -c "npx mcp-remote https://mcp.atlassian.com/v1/mcp"
Option 3: Development Setup
git clone https://github.com/kkokosa/repl-mcp.git
cd repl-mcp
pip install -e .
Usage
[!NOTE]
mcp-remotesidenote - Some MCP servers (like Atlassian) use OAuth for authentication and don’t support direct HTTP connections. Themcp-remoteMCP bridges this gap by handling OAuth flows locally and/or converting HTTP-based MCP servers to stdio transport. Beware that for OAuth-based servers,mcp-remoteneeds to receive the OAuth callback. If you’re running in an environment without a public URL (like WSL or a remote server), you’ll need a tunneling tool like ngrok to expose the callback endpoint.
Stdio Transport (command-based)
# Simple MCP server
repl-mcp -c "npx -y @modelcontextprotocol/server-filesystem /tmp"
# Remote MCP server via mcp-remote proxy (requires ngrok or similar for OAuth authorization!)
repl-mcp -c "npx mcp-remote https://mcp.atlassian.com/v1/mcp"
# Local Python MCP server
repl-mcp -c "python my_mcp_server.py"
# Using uvx
repl-mcp -c "uvx mcp-server-sqlite --db-path test.db"
HTTP Transport (URL-based)
# GitHub Copilot MCP
repl-mcp -url https://api.githubcopilot.com/mcp/ \
-H "Authorization: Bearer YOUR_GITHUB_TOKEN" \
-t http
# Notion MCP
repl-mcp -u https://mcp.notion.com/mcp
# Multiple headers
repl-mcp -u https://example.com/mcp \
-H "Authorization: Bearer TOKEN" \
-H "X-Custom-Header: value"
Using a config file
# If multiple servers in config, you'll be prompted to choose
repl-mcp --config sample-mcp-config.json
# Or select specific server directly
repl-mcp --config sample-mcp-config.json --server github
Config file formats
Stdio transport:
{
"command": "npx",
"args": ["mcp-remote", "https://mcp.atlassian.com/v1/mcp"]
}
설치
npx mcp-remote https://mcp.atlassian.com/v1/mcp설정
{
"mcpServers": {
"atlassian": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.atlassian.com/v1/mcp"]
},
"github": {
"url": "https://api.githubcopilot.com/mcp/",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
},
"notion": {
"url": "https://mcp.notion.com/mcp",
"headers": {}
}
}
}