MP

mavam/pi-mcporter

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

23 stars 4 forks Качество 75 Тренд 18MIT

Одноинструментальное расширение моста MCPorter для серверов pi и Model Context Protocol (MCP).

Обзор

Этот проект больше не поддерживается. Используйте pi-mcp-клиент для поддержки MCP в Pi. Используйте инструменты MCP от Pi через стабильный прокси-сервер mcporter с дополнительной нативной экспозицией инструмента, питаемой MCPorter. - Предпочитают местные CLI, когда это возможно (gh, git, kubectl, aws и т. Д.). Используйте MCP через mcporter, когда он добавляет четкое значение (например: Linear, Slack, размещенные интеграционные процессы, межинструментальные рабочие процессы). - Этот пакет намеренно является заменой нормального рабочего процесса, управляемого инструментами. - Начните с одного стабильного прокси-сервера mcporter и позвольте вам выбрать выбранные инструменты MCP для более богатой экспозиции - Используйте конфигурацию / время выполнения MCPorter в качестве источника истины - Поддерживает обнаружение (поиск), помощь в схеме (описание) и выполнение (звонок) - Возвращает полезные подсказки об ошибках для аута / оффлайн / http / stdio сбоев Node.js 24 или новее - MCPorter установлен и настроен по меньшей мере с одним MCP-сервером 3.

Обзор (машинный перевод)

[!Предупреждение] Этот проект больше не поддерживается. Использовать Pi-mcp-клиент вместо MCP Поддержка в Пи.

Используйте инструменты MCP от Pi через стабильный прокси-сервер mcporter необязательное нативное воздействие инструмента, приводимое в действие MCPorter.

Philosophy Философия: CLI > MCP

**pi в основном CLI-first. Предпочитают нативные CLI, когда они доступны ([T1], [T2], [T3], [T4] и т. Д.).

  • Используйте MCP через mcporter, когда он добавляет четкое значение (например: Linear, Slack, размещенные интеграционные процессы, межинструментальные рабочие процессы). Этот пакет намеренно является тонким мостом, а не заменой нормального рабочего процесса, управляемого инструментами.

Зачем использовать этот пакет

Начните с одного стабильного прокси-сервера mcporter и позвольте вам выбрать выбранные инструменты MCP для более богатой экспозиции. Используйте конфигурацию / время выполнения MCPorter в качестве источника истины Поддерживает обнаружение search, схему помощи describe и выполнение call Возвращает полезные подсказки об ошибках для сбоев auth/offline/http/stdio

Предпосылки

Тебе нужно:

Node.js 24 или новее MCPorter установлен и сконфигурирован как минимум с одним MCP-сервером

###Установка

###Быстрый старт

1 Подтвердите, что MCPorter видит ваши серверы:

  1. Начать пи:

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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

  1. Confirm MCPorter sees your servers:
npx mcporter list
  1. Start pi:
pi
  1. 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" }
Открыть полный README на GitHub

Установка

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