mcpresso
TypeScript framework to build robust, agent-ready MCP servers around your APIs.
GitHubスター
19
ユーザー評価
未評価
お気に入り
0
閲覧数
8
フォーク
4
イシュー
0
README
mcpresso · Make MCP servers actually usable
The toolkit that turns broken MCP servers into production-grade tools.
Quick Start
npx mcpresso init
cd my-server
npm run dev
Your MCP server is live at http://localhost:3000 in under 2 minutes.
Why mcpresso?
- Authentication - OAuth 2.1, bearer tokens, or none
- Resources - Automatic CRUD operations with type-safe validation
- Relationships - Define connections between resources
- Custom Methods - Extend beyond CRUD with business logic
- Multi-tenancy - User data injection and scope-based access
- Server Management - Rate limiting, retry with backoff, server metadata
We built 5 MCP servers before mcpresso. Every time, the same problems: boilerplate, broken auth, runtime failures. mcpresso fixes all of it.
Examples
- Hello World – minimal server
- Basic CRUD – resource management
- Custom Methods – beyond CRUD
- Multi-tenancy – user isolation
From pain to production
We wired Claude AI to a personal Airtable CMS. The naive server spammed list() and blew token limits. With mcpresso:
- Removed dumb
list()calls - Added enriched endpoints
- Collapsed 10+ calls into 1
Result: rebuilt in a weekend, stable in prod by Tuesday.
Read the story →
Documentation
- Getting Started - Complete beginner guide
- Core Concepts - Resources, schemas, authentication
- Examples - Working code examples
- CLI Reference - Command-line tools
MCP Standards Compliance
mcpresso follows the latest Model Context Protocol specifications including:
- Streamable HTTP Transport - Latest transport specification with SSE support for real-time communication
- OAuth 2.1 Authorization - Latest authorization standard as specified in MCP 2025-06-18
- Tools and Resources - Proper MCP tool definition and resource management
- Protocol Compliance - Full adherence to MCP lifecycle, message format, and error handling requirements
Templates
| Template | Use Case | Auth | Database |
|---|---|---|---|
| Express + No Auth | Public APIs, development | None | In-memory |
| Express + OAuth + SQLite | Small applications | OAuth 2.1 | SQLite |
| Docker + OAuth + PostgreSQL | Production deployments | OAuth 2.1 | PostgreSQL |
| Docker + Single User | Internal tools | API Key | None |
Contributing
We welcome contributions!
License
MIT © Granular Software