KR

kkokosa/repl-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

10 stars 3 forks 품질 68 트렌드 8MIT

모형 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-remote sidenote - 일부 MCP 서버 ( Atlassian과 같은) 인증을위한 OAuth를 사용하고 직접 HTTP 연결을 지원하지 않습니다. mcp-remote MCP는 로컬 및/또는 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

# 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-remote sidenote - Some MCP servers (like Atlassian) use OAuth for authentication and don’t support direct HTTP connections. The mcp-remote MCP 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-remote needs 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"]
}
GitHub에서 전체 README 보기

설치

npx mcp-remote https://mcp.atlassian.com/v1/mcp
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "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": {} } } }