MCP server pforge
Коммит 10 нояб. 2026 г.Создавайте MCP servers с помощью декларативной конфигурации YAML вместо написания шаблонного кода.
Также известен как paiml/pforge
- Звёзды
- 3
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- 0.1.2
- Последний коммит
- 10 нояб. 2026 г.
- Лицензия
- MIT
Что такое pforge MCP?
Создавайте MCP servers с помощью декларативной конфигурации YAML вместо написания шаблонного кода.
Сводка сгенерирована из README проекта
О pforge MCP server
Разработчики, которые хотят создавать Model Context Protocol servers без написания повторяющегося шаблонного кода, могут использовать pforge для определения своих инструментов через YAML-конфигурацию. Этот фреймворк генерирует оптимизированный код на Rust на основе ваших деклараций, работая поверх pmcp SDK для реализации протокола и транспорта. Вы можете управлять своим сервером, установив pforge-cli через Cargo и используя команду pforge serve для запуска проекта.
Система поддерживает четыре различных типа обработчиков для различных задач: нативные функции Rust для обеспечения типобезопасности, команды CLI для выполнения в оболочке, HTTP для проксирования эндпоинтов и конвейеры (pipelines) для объединения инструментов в цепочки. Несмотря на то, что фреймворк построен на Rust, он предлагает мост Deno/TypeScript, который позволяет определять обработчики с соблюдением типов и выполнять валидацию схем во время выполнения. Такой подход ускоряет разработку, позволяя сместить фокус с реализации протокола на логику инструментов и конфигурацию.
Что вы можете с ним делать
- 1Быстрое развертывание нового сервераРазработчик может быстро инициализировать структуру нового проекта, выполнив одну команду.
- 2Выполнение shell-команд в качестве инструментовВы можете создать MCP tool, который запускает локальные системные команды, используя тип обработчика CLI.
- 3Проксирование внешних веб-сервисовРазработчики могут создать сервер, который выступает в роли моста к существующим веб API, используя HTTP-обработчики.
- 4Создание серверов на TypeScriptПользователи, предпочитающие веб-технологии, могут реализовывать обработчики с помощью Deno и TypeScript вместо чистого Rust.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийpaiml/pforge is public and reachablegithub.com/paiml/pforge ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-11-10github.com/paiml/pforge ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на 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.
Вопросы о pforge MCP
Какие типы обработчиков поддерживает pforge?
pforge поддерживает типы обработчиков Native (функции Rust), CLI (команды оболочки), HTTP (проксирование эндпоинтов) и Pipeline (цепочки инструментов).
Можно ли создавать MCP servers с использованием TypeScript?
Да, pforge предоставляет мост Deno/TypeScript, который позволяет создавать типизированные MCP servers с помощью TypeScript и Deno.
Как установить pforge?
Вы можете установить CLI через Cargo, используя команду cargo install pforge-cli.
Когда стоит использовать pforge вместо прямого использования pmcp?
Используйте pforge, когда вам нужна декларативная конфигурация и быстрая разработка с минимальным объемом кода, в то время как pmcp лучше подходит для тонкой настройки деталей протокола.