概要

mcporter (MCPorter 🧳) は Model Context Protocol (MCP) のためのオープンソースの TypeScript ランタイム、CLI、およびコード生成ツールキット です。開発者や AI エージェントが設定された MCP サーバーを発見し、ツールを直接呼び出し、TypeScript で自動化を組み立て、任意の MCP エンドポイントから単一目的の CLI を生成することを可能にします。

Anthropic の「MCP を使用したコード実行」ガイダンスをサポートするために構築されており、AI エージェントが巨大な JSON スキーマを読み込む代わりに軽量な CLI バイナリを介してツールを呼び出すことができるため、ボイラープレートやコンテキストウィンドウの肥大化を排除します。

最新バージョン: 0.8.2 (2026年3月)。MIT ライセンス。

特徴

-P 設定不要な発見: ~/.mcporter/mcporter.json、プロジェクト設定、および Claude、Cursor、Codex、VS Code、Windsurf、OpenCode との連携から MCP サーバーを自動的に検出します。

• CLI ファーストのツール呼び出し: 自然な構文 (mcporter call linear.create_comment ...) または関数呼び出しスタイルでツールを実行 — スキーマの知識は不要です。

ワンコマンド CLI 生成: mcporter generate-cli により、任意の MCP サーバーからスタンドアロンで自己完結型の CLI (Bun/Node) を生成し、簡単な共有やエージェントの使用を実現します。

• 型付き TypeScript API: mcporter emit-ts は、強い型付け、デフォルト値、検証を備えた .d.ts インターフェースまたは完全なクライアントラッパーを生成します。
• 合成可能なランタイム: 接続プーリング、OAuth キャッシング、ログ追尾、および HTTP/SSE/stdio トランスポートのサポートを備えた createRuntime() + createServerProxy()。
• アドホック & デーモンモード: 任意の MCP エンドポイントに即座に接続; ステートフルなサーバー (例: chrome-devtools) をデーモンコマンドでウォームな状態に保ちます。

• AI エージェントフレンドリー: コンテキストの肥大化を削減 — エージェントは完全な MCP スキーマを埋め込む代わりに小さな CLI バイナリを呼び出します。

• 堅牢なツーリング: 自動修正、リッチな出力フォーマット (text(), json())、設定管理、およびデバッグヘルパー。

ユースケース

• AI エージェントツール統合: Claude/Cursor に生成された CLI を介して複雑な MCP サーバーを呼び出させ、コンテキストウィンドウの爆発を防ぎます。
• 迅速な自動化スクリプト作成: 完全な型安全性を備えて複数の MCP ツールを組み合わせる TypeScript ワークフローを構築します。
• ツール共有: チームまたは公共利用向けに単一目的の CLI (例: linear-comment) を生成および配布します。
• 開発 & デバッグ: プロトタイピング中に任意の MCP サーバースキーマを即座に検査したり、アドホックにツールを呼び出したりします。 . MCP の肥大化削減: エディター/エージェントでの重いスキーマ読み込みを軽量な CLI 呼び出しに置き換えます。

インストール & クイックスタート

即時実行 (インストール不要)

npx mcporter list
npx mcporter list linear --schema

グローバルインストール

npm install -g mcporter
# または Homebrew
brew tap steipete/tap && brew install steipete/tap/mcporter

呼び出し例

# コロン構文
mcporter call linear.create_comment issueId:ENG-123 body:'Looks good!'

# 関数呼び出し構文
mcporter call 'linear.create_comment(issueId: "ENG-123", body: "Looks good!")'

CLI の生成

mcporter generate-cli --command https://mcp.context7.com/mcp

### TypeScript の使用例
```ts
import { createRuntime } from "mcporter";
const runtime = await createRuntime();
const result = await runtime.callTool("context7", "resolve-library-id", {
  args: { libraryName: "react" }
});
console.log(result.text());
await runtime.close();

詳細なドキュメント、CLI リファレンス、および例はリポジトリにあります 。

mcporter の利点

MCP はツールを通じて AI エージェントに超能力を与えますが、スキーマや接続の管理は煩雑です。mcporter は MCP を エルゴノミック にします ― 一度発見したら即座に呼び出し、エージェント用の CLI を生成し、クリーンで型付けされたコードを書くことができます。究極の MCP スイスアーミーナイフです。

リンク

• GitHub: steipete/mcporter
• ウェブサイト: mcporter.dev
• CLI リファレンス & ドキュメント: github.com/steipete/mcporter/tree/main/docs

MCP を活用したあらゆる AI ワークフローに最適な相棒です。