Production-Ready MCP Tools

Build enterprise-grade MCP servers with our battle-tested, open-source library. Extracted from production systems and designed for real-world use.

View on GitHubNeed Custom Development?

What is the Model Context Protocol?

MCP is an open protocol that enables AI applications to securely connect to data sources and tools. Think of it as a universal connector for AI systems.

Why MCP Matters for Your Business

Universal Integration

Connect any AI application to your business tools and data sources using a standardized protocol.

Future-Proof

Build once, use with any MCP-compatible AI application as the ecosystem grows.

Secure by Design

Built-in security features protect your data while enabling powerful integrations.

Rapid Development

Leverage existing libraries and patterns to quickly build custom integrations.

BB MCP Server: Production-Ready MCP Library

A comprehensive Deno-based framework for building enterprise-grade MCP servers

Why Choose BB MCP Server

• Rapid Development: Plugin system with automatic discovery gets you productive immediately
• Enterprise-Ready: Built-in OAuth, dual transport support, and persistent storage for production deployments
• Type-Safe: Full TypeScript support with strict validation reduces bugs and improves maintainability
• Battle-Tested: Extracted from production MCP servers serving real businesses

Technical Features

• ✓Plugin system with automatic discovery and loading
• ✓OAuth provider and consumer for third-party integrations
• ✓STDIO and HTTP transport with session management
• ✓Deno KV-based storage with automatic cleanup and chunking
• ✓Comprehensive logging with audit trails and structured output
• ✓Full TypeScript with strict type checking
• ✓Extensive test utilities and examples
• ✓Published on JSR registry for easy installation

Get Started Quickly

The library includes 4 progressive examples that teach you everything from basic tools to advanced OAuth integration:

⭐ Simple MCP Server

Basic setup with utility tools and plugin discovery

⭐⭐ Plugin Workflows

Multi-step workflows for complex business logic

⭐⭐⭐ API & OAuth

Third-party API integration with authentication

⭐⭐⭐⭐ Manual Dependencies

Complete infrastructure control for advanced use cases

View on GitHubView on JSR

BB MCP Client Inspector

A comprehensive testing platform for MCP client implementations

What It Does

While the MCP Inspector exists as an MCP client for testing servers, this tool fills the inverse need - an MCP server for testing clients. The BB MCP Client Inspector provides an interactive web console for testing and validating MCP client implementations.

Key Features

• 🔍 Protocol Message Inspection - View all MCP JSON-RPC messages in real-time
• 🧠 Sampling Testing - Test client LLM completion capabilities
• ❓ Elicitation Testing - Test client user input request handling
• 🔔 Notification Testing - Trigger and verify list change notifications
• 🛠️ Inspector Tools - Six utility tools for testing scenarios
• 📊 Multi-Client Support - Test multiple clients simultaneously (HTTP mode)
• 🌐 Web Console - Interactive Fresh UI for testing

Quick Start

Run directly from JSR - no installation required:

deno run -A jsr:@beyondbetter/bb-mcp-client-inspector

This starts the MCP server on port 3000 and the web UI on port 8000.

Use Cases

MCP Client Development

Validate your MCP client implementation by testing sampling, elicitation, and notification handling in a controlled environment.

Protocol Debugging

Inspect all JSON-RPC messages in real-time to debug communication issues between clients and servers.

Integration Testing

Test multiple clients simultaneously in HTTP mode to verify consistent behavior across different implementations.

Inspector Tools

Six utility tools for comprehensive testing:

• ✓echo - Message echoing with optional delay and transformation
• ✓convert_date - Date/timezone conversion and formatting
• ✓calculate - Basic arithmetic operations
• ✓delay_response - Configurable delays for timeout testing
• ✓random_data - Generate random test data
• ✓trigger_error - Intentionally trigger errors for error handling tests

BB AppleScript MCP Server

Extend macOS workflows with AppleScript automation through MCP

What It Does

A production-ready MCP server that brings AppleScript automation to any MCP-compatible AI application. Built using BB MCP Server as a real-world example of what you can create with the library.

Key Capabilities

• Execute AppleScript code from AI conversations
• Read application dictionaries to discover capabilities
• Automate file management with Finder integration
• Manage permissions and check automation access

Quick Setup for Claude Desktop

Add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "bb-applescript": {
      "command": "deno",
      "args": [
        "run",
        "--allow-all",
        "--unstable-kv",
        "jsr:@beyondbetter/bb-applescript-mcp-server"
      ]
    }
  }
}

Full Documentation

View on JSRView on GitHub

Use Cases

Developer Workflows

Automate BBEdit projects, manipulate files, and integrate with development tools through AI conversations.

File Management

Organize files, set labels, retrieve selections, and manage your file system with natural language.

App Automation

Control macOS applications that support AppleScript through your AI assistant.

Ready to build your own MCP server?

Use our open-source library to get started today, or talk to us about a custom solution built for your business.

Custom Development ServicesExplore the Library

🤖 Recommended: Build with Beyond Better

We strongly recommend using Beyond Better to develop your MCP server applications. BB provides project-wide intelligence, smart code generation, and comprehensive guidelines support that makes MCP development significantly faster and more reliable.

Why BB for MCP Development?

• ✓ Project-wide understanding of MCP architecture
• ✓ Generate boilerplate and follow best practices
• ✓ Use our comprehensive consumer guidelines
• ✓ Debug and refine implementations faster

Get Started

• ✓ BB Cloud: Web-based interface (easiest)
• ✓ Self-Hosted: Full control and privacy
• ✓ Local-Only: No cloud dependencies
• ✓ Free & open source

Learn More About BB