·

MCPC

既存の MCP ツールを組み合わせて、エージェント型の MCP サーバーを構築します。

MCPC は、エージェント型 MCP（Model Context Protocol）サーバーを構築するための SDK です。次のことができます。

1. 高性能なエージェント型 MCP ツールを作成する： 実現したいことをテキストで説明し、 拡大を続ける MCP コミュニティのツールを参照するだけです。 標準的な MCP ツールとして、エージェントはどこでも動作し、シームレスに連携できます。
2. 既存のツールを微調整する： 既存のツールの説明やパラメーターを柔軟に変更したり、結果をラップしてフィルタリングしたりして、特定のビジネスシナリオに正確に適合させることができます。
3. マルチエージェントシステムを構築する： 各エージェントを MCP ツールとして定義し、それらを組み合わせてオーケストレーションすることで、高度な協調型マルチエージェントシステムを構築できます。

主な機能

• 移植性とエージェントの相互運用性：一度構築すれば、MCP ツールとしてどこでも実行できます。エージェントはすべての MCP クライアントで動作し、標準的な MCP インターフェースを通じて互いを検出し、連携できます
• シンプルな合成と微調整：MCP サーバーを構成要素として組み合わせ、ツールを選択してカスタマイズしたり、説明やパラメーターを変更したりできます
• ログ記録とトレース：MCP のログ記録と OpenTelemetry トレースを標準でサポート
• スキルのサポート：Agent Skills 仕様に従ってドメイン固有のナレッジを定義できます。本番環境へのデプロイ、MCP 経由での共有、ツールの依存関係の宣言が可能です
• 柔軟な実行モード：さまざまなシナリオに対応する複数の専用モードを用意しています。インタラクティブエージェント（agentic）、AI SDK サンプリング（ai_sampling）、AI ACP モード（ai_acp）、セキュアなコード実行（code_execution）、サンドボックス＋サンプリング（code_execution_sampling）があり、それぞれに専用の実装が用意されています

クイックスタート

はじめるための3つの方法

1. ウェブサイトを使う（最速）

mcpc.tech にアクセスして、公式 MCP レジストリのサーバーを閲覧し、ツールを見つけて、すぐに使えるエージェントを生成しましょう。

2. エージェントを使う（対話型）

AI にサーバーの検索やエージェントの構築を手伝ってもらいましょう。

MCP クライアントに追加します：

{
  "mcpServers": {
    "mcpc-builder-agent": {
      "command": "npx",
      "args": ["-y", "@mcpc-tech/builder", "mcpc-builder-agent"]
    }
  }
}

3. コードを書く（完全な制御）

SDK を直接使用して、すべてをカスタマイズできます。以下の例をご覧ください。

---

インストール

# npm (from npm registry)
npm install @mcpc-tech/core
# npm (from jsr)
npx jsr add @mcpc/core

# deno
deno add jsr:@mcpc/core

# pnpm (from npm registry)
pnpm add @mcpc-tech/core
# pnpm (from jsr)
pnpm add jsr:@mcpc/core

または、CLI で直接実行できます（インストール不要）。

# Run with remote configuration
npx -y @mcpc-tech/cli --config-url \
  "https://raw.githubusercontent.com/mcpc-tech/mcpc/main/packages/cli/examples/configs/codex-fork.json"

例：シンプルな Codex／Claude Code のフォークを作成する

import { mcpc } from "@mcpc/core";

const server = await mcpc(
  [{ name: "coding-agent", version: "0.1.0" }, { capabilities: { tools: {} } }],
  [{
    name: "coding-agent",
    description: `
      You are a coding assistant with advanced capabilities.

      Your capabilities include:
      - Reading and writing files
      - Executing terminal commands to build, test, and run projects
      - Interacting with GitHub to create pull requests and manage issues

      Available tools:
      <tool name="desktop-commander.execute_command" />
      <tool name="desktop-commander.read_file" />
      <tool name="desktop-commander.write_file" />
      <tool name="github.create_pull_request" />
    `,
    deps: {
      mcpServers: {
        "desktop-commander": {
          command: "npx",
          args: ["-y", "@wonderwhy-er/desktop-commander@latest"],
          transportType: "stdio",
        },
        github: {
          transportType: "streamable-http",
          url: "https://api.githubcopilot.com/mcp/",
        },
      },
    },
  }],
);

完全な例：詳細は Codex フォークのチュートリアルをご覧ください。

MCPC Core スキルをインストールする

skills.shを使って、mcpc-core スキルをプロジェクトにインストールします。

npx skills add mcpc-tech/mcpc

これにより、スキルは .agents/skills/mcpc-core/ にインストールされ、エージェントは必要に応じて @mcpc/core の API リファレンス全体、使用パターン、プラグインガイド、注意点を参照できるようになります。

---

例：エージェントスキルを読み込む

インラインの description が長くなりすぎる複雑なエージェントでは、 Agent Skillsを使って、必要に応じて読み込むドメイン知識を個別のファイルに整理します。

import { createBashPlugin, createSkillsPlugin } from "@mcpc/core/plugins";

const server = await mcpc(
  [{ name: "my-agent", version: "1.0.0" }, { capabilities: { tools: {} } }],
  [{
    name: "my-agent",
    description: 'An agent with domain knowledge\n\n<tool name="bash"/>',
    plugins: [
      createSkillsPlugin({ paths: ["./skills"] }),
      createBashPlugin(),
    ],
  }],
);

スキルは必要に応じてドメイン知識を読み込み、bash プラグインはスクリプトの実行を可能にします。scripts/ ディレクトリ内のスクリプトについては、スキルがパスを返すため、bash ツールを使って実行してください。

完全な例：詳しくは 14-skills-plugin.tsと 25-skills-with-bash.tsをご覧ください。

例：マニュアルを段階的に開示する

詳細な指示を持つエージェントでは、manual フィールドを使って、初期プロンプトの長さを抑えられます。完全なマニュアルは、man { manual: true } を使って必要なときに取得できます。

const server = await mcpc(
  [{ name: "code-reviewer", version: "1.0.0" }, {
    capabilities: { tools: {} },
  }],
  [{
    name: "code-reviewer",
    description: "AI code reviewer for quality and security analysis.",
    manual: `Detailed review guidelines...
<tool name="desktop-commander.read_file"/>
<tool name="desktop-commander.write_file"/>

## Review Categories
1. Code Quality - readability, naming, complexity
2. Security - SQL injection, XSS, credentials
...`,
    deps: {
      mcpServers: {
        "desktop-commander": {
          command: "npx",
          args: ["-y", "@wonderwhy-er/[email protected]"],
          transportType: "stdio",
        },
      },
    },
  }],
);

完全な例：詳しくは 21-progressive-manual.tsをご覧ください。

仕組み

簡単な3つのステップです。

1. 依存関係を定義する - 使用するMCPサーバーを一覧にします
2. エージェントの説明を記述する - エージェントの役割を説明し、ツールを参照します
3. サーバーを作成する - mcpc() を使ってサーバーを構築し、接続します

実行モード

MCPCは、さまざまなシナリオに対応する柔軟な実行モードを複数提供しています。

モード	説明	使用例	プラグインが必要
agentic	対話形式のステップごとの実行	標準的なエージェントとのやり取り	組み込み
ai_sampling	AI SDKサンプリングモード	自律的なAI SDK実行	組み込み
ai_acp	AI SDK ACPモード	コーディングエージェント（Claude Codeなど）	組み込み
code_execution	ツールにアクセスできる安全なJavaScriptサンドボックス	コードの生成と実行	外部
code_execution_sampling	MCPサンプリングによる呼び出し機能を備えた安全なサンドボックス	クライアントのモデルにも問い合わせできるサンドボックス実行	外部

注： agentic、ai_sampling、ai_acp は組み込みモードです。options.mode を設定するだけで使用できます。code_execution と code_execution_sampling を使うには、それぞれのプラグインパッケージをインストールして読み込む必要があります。

簡単な例

// Interactive agent (default)
{ options: { mode: "agentic" } }

// Autonomous agent
{ options: { mode: "ai_sampling", samplingConfig: { maxIterations: 10 } } }

// Code execution with sandbox
import { createCodeExecutionPlugin } from "@mcpc/plugin-code-execution/plugin";
{
  plugins: [createCodeExecutionPlugin()],
  options: { mode: "code_execution" }
}

詳細なドキュメント： 各モード、設定オプション、ベストプラクティスの詳細については、 実行モードガイドをご覧ください。

ドキュメント

• はじめに - インストールと 最初の手順
• 初めてのエージェントの作成 - 完全なチュートリアル
• 実行モード - すべての 実行モードの詳細ガイド
• CLIの使用ガイド - MCPC CLIの使用方法
• ログ記録とトレース - MCPのログ記録と OpenTelemetryのトレース
• 例 - 実際のユースケース
• よくある質問 - よくある質問と回答

例

examplesディレクトリで動作する例をご覧いただくか、 Codexフォークのチュートリアルをご確認ください。

貢献

皆さまからの貢献を歓迎します。詳細はCONTRIBUTING.mdをご覧ください。

ライセンス

MITライセンスです。詳細はLICENSEをご覧ください。