pforge MCP server
Commit 10 Nov 2026Bangun MCP server menggunakan konfigurasi YAML deklaratif alih-alih menulis boilerplate code.
Juga dikenal sebagai paiml/pforge
- Stars
- 3
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.1.2
- Commit terakhir
- 10 Nov 2026
- Lisensi
- MIT
Apa itu pforge MCP?
Bangun MCP server menggunakan konfigurasi YAML deklaratif alih-alih menulis boilerplate code.
Ringkasan dibuat dari README proyek
Tentang pforge MCP server
Developer yang ingin membuat Model Context Protocol server tanpa menulis boilerplate code yang berulang dapat menggunakan pforge untuk mendefinisikan tool mereka melalui konfigurasi YAML. Framework ini menghasilkan kode Rust yang teroptimasi dari deklarasi Anda, yang berjalan di atas SDK pmcp untuk menangani implementasi protokol dan transport. Anda dapat mengelola server Anda dengan menginstal pforge-cli via Cargo dan menggunakan perintah pforge serve untuk menjalankan proyek Anda.
Sistem ini mendukung empat tipe handler berbeda untuk memenuhi berbagai kebutuhan: fungsi Rust native untuk type safety, perintah CLI untuk eksekusi shell, HTTP untuk proxying endpoint, dan pipeline untuk merangkai tool secara berurutan. Meskipun dibangun di atas Rust, pforge menawarkan bridge Deno/TypeScript yang memungkinkan definisi handler yang type-safe dan validasi schema saat runtime. Pendekatan ini memungkinkan pengembangan cepat dengan mengalihkan fokus dari urusan teknis protokol ke logika tool dan konfigurasi.
Apa yang bisa Anda lakukan dengannya
- 1Scaffolding server baru dengan cepatDeveloper dapat dengan cepat menginisialisasi struktur proyek baru hanya dengan menjalankan satu perintah.
- 2Menjalankan perintah shell sebagai toolAnda dapat membuat MCP tool yang menjalankan perintah sistem lokal menggunakan tipe handler CLI.
- 3Proxy layanan web eksternalDeveloper dapat membangun server yang berfungsi sebagai jembatan ke API web yang sudah ada menggunakan handler HTTP.
- 4Membangun server menggunakan TypeScriptPengguna yang lebih menyukai teknologi web dapat mengimplementasikan handler menggunakan Deno dan TypeScript alih-alih menggunakan Rust murni.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkaupaiml/pforge is public and reachablegithub.com/paiml/pforge ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-10github.com/paiml/pforge ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubpforge
A declarative framework for building Model Context Protocol (MCP) servers using YAML configuration.
MCP Server
Registry Name: io.github.paiml/pforge
pforge is available in the Model Context Protocol (MCP) Registry. Install it via:
# Via Cargo (recommended)
cargo install pforge-cli
# Then run as MCP server
pforge serve
For Maintainers: See MCP Registry Publishing Guide for publishing instructions.
What is pforge?
pforge lets you define MCP servers in YAML instead of writing boilerplate code. It's built on top of pmcp (rust-mcp-sdk) and generates optimized Rust code from your configuration.
Quick example:
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 }
Installation
# From crates.io
cargo install pforge-cli
# From source
git clone https://github.com/paiml/pforge
cd pforge
cargo install --path crates/pforge-cli
Quick Start
# Create new project
pforge new my-server
cd my-server
# Run the server
pforge serve
The scaffolded project includes a working example handler. Edit pforge.yaml to add more tools, then implement handlers in src/handlers/.
Handler Types
pforge supports four handler types:
- Native - Rust functions with full type safety
- CLI - Execute shell commands
- HTTP - Proxy HTTP endpoints
- Pipeline - Chain multiple tools together
See the book for detailed examples of each type.
Language Bridges
pforge provides language bridges for building MCP servers in your preferred language:
Deno/TypeScript Bridge
Build type-safe MCP servers using TypeScript and Deno with native performance:
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);
Features:
- Type-safe handler definitions with TypeScript generics
- Runtime schema validation with no external dependencies
- O(1) handler lookup performance
- Both sync and async handler support
- 74+ tests passing with full quality gates
Documentation: bridges/deno/README.md
Coming Soon
- Python bridge (FFI-based with asyncio support)
- Go bridge (CGo-based with goroutine support)
- Node.js bridge (Native addon with N-API)
Documentation
- Book - Complete guide with examples and comparisons
- Architecture - Technical design details
- User Guide - Usage guide
- Implementation Status - Current project status
- CLAUDE.md - Development workflow for contributors
Examples
- hello-world - Minimal native handler example
- calculator - Math operations with tests
- rest-api-proxy - HTTP handler examples
Project Status
Version: 0.1.2
Published crates:
pforge-config- Configuration parsingpforge-macro- Procedural macrospforge-runtime- Core runtime (depends on pmcp)pforge-codegen- Code generationpforge-cli- CLI tool
Test results: 120+ tests passing (90+ unit/integration, 12 property-based, 8 quality gates, 5+ doctests)
See IMPLEMENTATION_STATUS.md for detailed progress.
Development
# Run tests
cargo test --all
# Run quality gates
make quality-gate
# Watch mode
make watch
# Build release
make build-release
See CLAUDE.md for full development workflow.
Architecture
pforge is built as a framework on top of pmcp (rust-mcp-sdk):
┌─────────────────────────────────┐
│ pforge (Framework Layer) │
│ - YAML → Rust codegen │
│ - Handler registry │
│ - State management │
└─────────────────────────────────┘
↓
┌─────────────────────────────────┐
│ pmcp (Protocol SDK) │
│ - MCP protocol implementation │
│ - Transport handling │
└─────────────────────────────────┘
When to use pmcp directly: You need fine-grained control over MCP protocol details or want to avoid code generation.
When to use pforge: You want declarative configuration and rapid MCP server development with less code.
Contributing
Contributions are welcome. Please:
- Read CLAUDE.md for development standards
- Check ROADMAP.md for current priorities
- Ensure tests pass:
cargo test --all - Ensure quality gates pass:
make quality-gate
All commits are validated by pre-commit hooks that check code formatting, linting, tests, complexity, coverage, and markdown link validity (using pmat validate-docs) to prevent broken documentation links.
License
MIT - see LICENSE
Acknowledgments
Built on pmcp by Pragmatic AI Labs.
Pertanyaan tentang pforge MCP
Apa saja tipe handler berbeda yang didukung oleh pforge?
pforge mendukung tipe handler Native (fungsi Rust), CLI (perintah shell), HTTP (proxying endpoint), dan Pipeline (merangkai tool).
Bisakah saya membangun MCP server menggunakan TypeScript?
Ya, pforge menyediakan bridge Deno/TypeScript yang memungkinkan Anda membangun MCP server yang type-safe menggunakan TypeScript dan Deno.
Bagaimana cara menginstal pforge?
Anda dapat menginstal CLI melalui Cargo menggunakan perintah 'cargo install pforge-cli'.
Kapan saya harus menggunakan pforge alih-alih pmcp secara langsung?
Gunakan pforge saat Anda menginginkan konfigurasi deklaratif dan pengembangan cepat dengan lebih sedikit kode, sedangkan pmcp lebih baik untuk kontrol mendalam terhadap detail protokol.