Pforge

🚀 pforge

pforgeは、YAML構成を使用してModel Context Protocol (MCP) サーバーを構築するための宣言的なフレームワークです。このフレームワークにより、開発者はボイラープレートコードを書く代わりに、YAMLファイルでMCPサーバーを定義することができます。

🚀 クイックスタート

新しいプロジェクトの作成

pforge new my-server
cd my-server

サーバーの起動

pforge serve

スキャフォールドされたプロジェクトには、動作するサンプルハンドラーが含まれています。pforge.yamlを編集してさらにツールを追加し、src/handlers/にハンドラーを実装します。

✨ 主な機能

• 宣言的構成：YAML構成を使用してMCPサーバーを定義し、ボイラープレートコードを削減します。
• 複数のハンドラータイプ：Native、CLI、HTTP、Pipelineの4種類のハンドラータイプをサポートします。
• 言語ブリッジ：Deno/TypeScript、Python、Go、Node.jsなどの言語でMCPサーバーを構築するためのブリッジを提供します。

📦 インストール

crates.ioからのインストール

cargo install pforge-cli

ソースからのインストール

git clone https://github.com/paiml/pforge
cd pforge
cargo install --path crates/pforge-cli

💻 使用例

基本的な使用法

forge:
  name: my-server
  version: 0.1.0
  transport: stdio

tools:
  - type: native
    name: greet
    description: "Greet someone"
    handler:
      path: handlers::greet_handler
    params:
      name: { type: string, required: true }

高度な使用法

Deno/TypeScriptブリッジの使用

import { PforgeBridge } from "https://raw.githubusercontent.com/paiml/pforge/main/bridges/deno/bridge.ts";

const bridge = new PforgeBridge();

bridge.register({
  name: "greet",
  description: "Greet a user by name",
  handler: (input: { name: string }) => ({
    success: true,
    data: { message: `Hello, ${input.name}!` },
  }),
});

const result = await bridge.execute("greet", { name: "Alice" });
console.log(result.data);

📚 ドキュメント

• Book - 例と比較を含む完全なガイド
• Architecture - 技術的な設計詳細
• User Guide - 使用ガイド
• Implementation Status - 現在のプロジェクトの状況
• CLAUDE.md - 貢献者向けの開発ワークフロー

🔧 技術詳細

アーキテクチャ

pforgeはpmcp (rust-mcp-sdk) の上に構築されたフレームワークです。

┌─────────────────────────────────┐
│   pforge (Framework Layer)      │
│   - YAML → Rust codegen         │
│   - Handler registry            │
│   - State management            │
└─────────────────────────────────┘
              ↓
┌─────────────────────────────────┐
│   pmcp (Protocol SDK)           │
│   - MCP protocol implementation │
│   - Transport handling          │
└─────────────────────────────────┘

ハンドラータイプ

pforgeは4種類のハンドラータイプをサポートしています。

1. Native - 完全な型安全性を持つRust関数
2. CLI - シェルコマンドを実行
3. HTTP - HTTPエンドポイントをプロキシ
4. Pipeline - 複数のツールを連鎖させる

詳細な例については、book を参照してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細は LICENSE を参照してください。