f/mcp-startup-boilerplate

A robust, free, ready-to-use Rails boilerplate for building AI-powered applications that integrate seamlessly with Claude AI using the Model Context Protocol (MCP). This boilerplate includes user authentication and OAuth2 provider capabilities out of the box.
## 🚀 Features
User Authentication: Complete authentication system powered by Devise
OAuth2 Provider: Full OAuth2 server implementation with Doorkeeper
MCP Integration: Seamless Claude AI integration using fast-mcp
Payment Processing: Integrated Stripe payments for tools with subscription options
Modern Rails: Built on Rails 8.0.2 with the latest features
Tailwind CSS: Beautiful, responsive UI with Tailwind
Hotwire: Modern, fast frontend with Turbo and Stimulus
## 📋 Requirements
Ruby 3.2+
PostgreSQL
Node.js & Yarn (for frontend assets)
Stripe Account (for payment processing)
## 🔧 Setup
### 1. Clone the repository
bash
git clone https://github.com/f/mcp-startup-boilerplate mcp-startup
cd mcp-startup
### 2. Install dependencies
bash
bundle install
yarn install
### 3. Setup the database
bash
rails db:create db:migrate db:seed
### 4. Configure Stripe (optional for payment features)
Set your Stripe API keys in your environment:
bash
export STRIPEPUBLISHABLEKEY="pktestyourkey"
export STRIPESECRETKEY="sktestyourkey"
export STRIPEWEBHOOKSECRET="whsecyourwebhookkey"
For development, you can also update these in config/initializers/stripe.rb
### 5. Start the server
bash
rails server
Your application should now be running at http://localhost:3000
## 💳 Payment Integration
This application comes with built-in Stripe payment processing for MCP tools:
### Subscription Plans
Standard Plan: $0.03 per tool call with 40% savings compared to pay-as-you-go
Enterprise Plan: $0.03 per tool call with additional benefits and unlimited usage
### Pay-Per-Use Pricing
Default pricing: $0.05 per tool call (can be customized per tool)
### Payment Management
User-friendly subscription management interface
Detailed usage tracking dashboard
Tool usage history and analytics
## 🧰 Paid Tool Framework
The application includes a PaidTool base class that allows you to easily create tools that require payment:
ruby
class YourPaidTool < PaidTool
description "Your paid tool description"
# Custom pricing (optional, defaults to $0.05)
def pricecents
8 # $0.08 per call
end
def call
return { error: "User has no active subscription" } unless chargeuser
# Your implementation here after charge
end
end
### How PaidTool Works
1. When a tool is called, it first checks if the user has an active subscription
2. If subscribed, the tool executes and logs usage without additional charges
3. If not subscribed, the user is charged the tool's price via Stripe
4. All tool usage is tracked for analytics and billing purposes
### Extending PaidTool
You can customize pricing and behavior by:
Overriding pricecents to set custom pricing for specific tools
Creating different tool categories with varying price points
Adding tool-specific features for premium subscription tiers
## 🔒 OAuth2 Integration
This boilerplate comes with a complete OAuth2 server implementation powered by Doorkeeper. Key endpoints:
OAuth Authorization: /oauth/authorize
Token Endpoint: /oauth/token