OmniMCP - Universal Model Context Protocol Client

The complete toolkit for building AI-powered applications with Model Context Protocol (MCP) support.
What is OmniMCP?
OmniMCP is a comprehensive SDK for integrating with MCP servers, enabling seamless communication between AI models and external tools. It provides both CLI and programmatic interfaces for maximum flexibility.
Quick Install
npm install omnimcp
Features
- 🚀 Multiple Transport Types: stdio, SSE, and HTTP support
- 🤖 AI Integration: Built-in OpenAI and Anthropic support
- 🛠️ CLI & Web UI: Interactive tools for testing and debugging
- 🔄 Automatic Retries: Smart retry logic with exponential backoff
- 📝 TypeScript Support: Full type safety and IntelliSense
- 🎯 Error Handling: Comprehensive error messages with recovery hints
Quick Start
CLI Usage
npx omnimcp web
npx omnimcp connect --transport stdio --command "node server.js"
npx omnimcp tools list
Programmatic Usage
import { MCPClient } from '@omnimcp/client';
const client = new MCPClient('my-app', '1.0.0');
await client.connect({
type: 'stdio',
options: {
command: 'node',
args: ['path/to/mcp-server.js']
}
});
const tools = await client.tools.list();
console.log('Available tools:', tools);
const result = await client.tools.call({
name: 'get_weather',
arguments: { city: 'San Francisco' }
});
AI Integration
import { MCPClientWithAI } from '@omnimcp/client/providers';
const client = new MCPClientWithAI('my-app', '1.0.0', {
apiKey: process.env.OPENAI_API_KEY,
provider: 'openai'
});
await client.connect({
type: 'stdio',
options: { command: 'mcp-server' }
});
const response = await client.queryAI(
"What's the weather in Tokyo?",
{ model: 'gpt-4' }
);
Package Structure
This package includes:
- @omnimcp/core - Core types and utilities
- @omnimcp/client - Node.js client library
- @omnimcp/cli - Command-line interface
- @omnimcp/web - Web UI for testing
Documentation
For detailed documentation, examples, and API reference, visit:
License
MIT © OmniMCP Team