mavam/pi-mcporter

Developer tools

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

23 stars 4 forks 품질 75 트렌드 18MIT

Repository Install

파이 및 모델 Context Protocol (MCP) 서버에 대한 단일 도구 MCPorter 브리지 확장.

개요

이 프로젝트는 더 이상 유지되지 않습니다. Pi에서 기본 MCP 지원 대신 pi-mcp-client를 사용하십시오. MCPorter에 의해 구동되는 선택적인 기본 공구 노출을 가진 안정되어 있는 mcporter 프록시를 통해 Pi에서 MCP 공구를 사용하십시오. - - 사용할 때마다 Prefer native CLI(gh, git, kubectl, aws, etc.). - Mcporter를 통해 MCP를 사용하여 clear 값(예를 들어: Linear, Slack, 호스팅된 auth-heavy 통합, 크로스툴 워크플로우)을 추가합니다. - - - 이 패키지는 의도적으로 pi의 정상적인 도구 중심 워크플로우에 대한 대체가 아닙니다. - 하나의 안정적인 mcporter 프록시로 시작하면 MCP 도구를 부유 한 노출으로 선택 할 수 있습니다. MCPorter config/runtime을 true 소스로 사용하십시오 - 발견 (search), 스키마 도움말 (describe) 및 실행 (call) - auth/offline/http/stdio 실패에 대한 유용한 오류 힌트를 반환합니다. - Node.js 24 또는 newer - MCPorter는 적어도 하나의 MCP 서버로 설치 및 구성 3. 명세.

개요(AI 번역)

[!수신] 이 프로젝트는 더 이상 유지되지 않습니다. 제품 정보 기본 MCP 대신 pi-mcp-client Pi 지원.

안정적으로 Pi에서 MCP 도구를 사용하여 mcporter 프록시 선택적 기본 도구 노출, 전원 MCPorter.

철학: CLI > MCP

-pi는 기본적으로 CLI-first입니다.

사용할 때마다 Prefer native CLI (gh, git], kubectl], aws 등).
MCP를 사용하여 mcporter]를 사용하여 명확한 값을 추가할 때 (예를 들면: 선형, Slack, auth-heavy 통합, 크로스툴 워크플로우).
이 패키지는 의도적으로 thin bridge, pi의 정상적인 도구 중심 워크플로우의 교체가 아닙니다.

✨ 왜 이 패키지를 사용

1개의 안정된 mcporter 프록시를 시작으로 MCP 툴을 풍부한 노출으로 선택하도록 합니다.
진실의 근원으로 MCPorter config/runtime를 사용하십시오
검색 지원 (search), 스키마 도움말 (describe]), 실행 (call)
auth/offline/http/stdio 실패를 위한 유용한 과실 hints를 돌려보냅니다

Pre Pre

당신은:

Node.js 24 이상
MCPorter 설치 및 구성 적어도 하나의 MCP 서버

♨ 설치

⭐ 빠른 시작

MCPorter가 서버를 확인합니다.
시작 pi:
명세.

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

README

원문 README의 일부입니다. 원문 보기.

🧳 pi-mcporter

[!WARNING] This project is no longer maintained. Use pi-mcp-client instead for native MCP support in Pi.

Use MCP tools from Pi through a stable mcporter proxy with optional native tool exposure, powered by MCPorter.

🧠 Philosophy: CLI > MCP

pi is fundamentally CLI-first.
Prefer native CLIs whenever available (gh, git, kubectl, aws, etc.).
Use MCP via mcporter when it adds clear value (for example: Linear, Slack, hosted auth-heavy integrations, cross-tool workflows).
This package is intentionally a thin bridge, not a replacement for pi’s normal tool-driven workflow.

✨ Why use this package

Starts with one stable mcporter proxy and lets you opt selected MCP tools into richer exposure
Uses your MCPorter config/runtime as source of truth
Supports discovery (search), schema help (describe), and execution (call)
Returns useful error hints for auth/offline/http/stdio failures

📋 Prerequisites

You need:

Node.js 24 or newer
MCPorter installed and configured with at least one MCP server

npm install -g mcporter
npx mcporter list          # verify your servers are visible

🚀 Installation

pi install npm:pi-mcporter

🚀 Quick start

Confirm MCPorter sees your servers:

npx mcporter list

Start pi:

pi

Ask for what you need and pi picks the right MCP tools automatically:

What are my open Linear issues this sprint?
Catch me up on #engineering in Slack from today.
Find the onboarding runbook in Notion and summarize the setup steps.

🔍 The three actions

The mcporter tool has three actions that map to a natural discovery → execution workflow.

`search`: find servers and tools

Use a known MCP server name or a natural-language capability phrase when you don’t know the exact tool selector:

{ "action": "search", "query": "linear", "limit": 5 }

{ "action": "search", "query": "find a tool for creating Linear issues", "limit": 5 }

Search returns matching server names and server.tool selectors with short descriptions. A server name confirms that MCPorter knows the integration, but it isn’t callable by itself. Choose a tool selector from the results, then use describe and call.

If authentication or connectivity prevents pi-mcporter from loading a server’s tools, the server still appears as a known MCP server. The result identifies the unavailable metadata and suggests authentication or connectivity recovery instead of reporting that the server doesn’t exist.

`describe`: get the full schema for a tool

Use when you know the selector but need to see its required parameters before calling.

{ "action": "describe", "selector": "linear.create_issue" }

GitHub에서 전체 README 보기

설치

npx mcporter list # verify your servers are visible

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "linear": {
      "baseUrl": "https://mcp.linear.app/mcp",
      "headers": {
        "Authorization": "Bearer ${LINEAR_API_KEY}"
      }
    },
    "everything": {
      "command": "npx -y @modelcontextprotocol/server-everything"
    }
  }
}