Pforge

🚀 pforge

pforge是一個聲明式框架，可藉助YAML配置來構建模型上下文協議（MCP）服務器，簡化了服務器的創建過程，提高開發效率。

🚀 快速開始

新建項目

pforge new my-server
cd my-server

運行服務器

pforge serve

搭建好的項目包含一個可用的示例處理程序。你可以編輯 pforge.yaml 文件來添加更多工具，然後在 src/handlers/ 中實現處理程序。

✨ 主要特性

• 聲明式配置：使用YAML配置文件定義MCP服務器，避免編寫樣板代碼。
• 多語言支持：提供Deno/TypeScript橋接，未來還將支持Python、Go和Node.js。
• 多種處理程序類型：支持原生、CLI、HTTP和管道處理程序類型。
• 代碼生成：從YAML配置生成優化的Rust代碼。

📦 安裝指南

從crates.io安裝

cargo install pforge-cli

從源代碼安裝

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

💻 使用示例

基礎用法

YAML配置示例

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);

📚 詳細文檔

• 手冊：包含示例和比較的完整指南。
• 架構：技術設計細節。
• 用戶指南：使用指南。
• 實現狀態：當前項目狀態。
• CLAUDE.md：貢獻者的開發工作流程。

🔧 技術細節

pforge構建在pmcp（rust-mcp-sdk）之上，作為一個框架提供了從YAML配置到Rust代碼的生成、處理程序註冊和狀態管理等功能。

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

• 何時直接使用pmcp：當你需要對MCP協議細節進行細粒度控制或希望避免代碼生成時。
• 何時使用pforge：當你希望通過聲明式配置快速開發MCP服務器並減少代碼編寫時。

📄 許可證

本項目採用MIT許可證，詳情請見 LICENSE。

致謝

本項目基於Pragmatic AI Labs的 pmcp 構建。