Features
This monorepo contains two packages built with TypeScript and Zod:
@stackone/mcp-connectors - Pre-built connectors for popular SaaS tools
- 35+ production-ready MCP connectors
- Typesafe wrapper around MCP capabilities
- Local development with auto-reload
- No dependencies on server runtime or transport
- Runs on Bun, Node, and Cloudflare Workers
@stackone/mcp-config-types - Shared configuration types
- Zod schemas for connector credentials and setup fields
- TypeScript types for all connector configurations
- Designed for AI coding agents (Claude, Cursor, etc.)
- Enables type-safe connector development
Usage
For End Users
The MCP connectors in this repo power disco.dev - the easiest way to connect your favourite tools to your favourite AI applications using the Model Context Protocol.
Go to disco.dev to get started with zero setup.
For Developers
Use these packages to build your own MCP servers:
npm install @stackone/mcp-connectors @stackone/mcp-config-types
The connectors can be imported and used in your own MCP server implementations, and the config types provide TypeScript definitions for all connector configurations.
Getting Started (First Time Setup)
If you want to run the connectors locally or contribute to the project:
-
Clone the repository:
git clone https://github.com/stackone-ai/mcp-connectors.git cd mcp-connectors -
Install Bun (if you don't have it already):
curl -fsSL https://bun.sh/install | bash -
Install dependencies:
bun install -
Build the project:
bun run build -
Run the tests:
bun test -
Check out the documentation:
- See the
docs/directory for detailed guides - Start with Running Locally for setup instructions
- Read Writing Connectors to create your own
- See the
Usage
This is a monorepo managed with Bun and Turbo.
Start a server from a connector
No credentials needed:
# Start a test server in the background
bun run server -- -- --connector test
bun run server -- -- --connector documentation
# Start with credentials (credentials object schema may be different for each connector)
bun run server -- -- --connector github --credentials '{"token":"ghp_xxx"}'
Server runs at http://localhost:3000/mcp
Package structure
packages/mcp-connectors/- The main connectors packagepackages/mcp-config-types/- Shared configuration types
Available Connectors
Popular integrations: asana, github, slack, notion, jira, linear, todoist, google-drive, supabase
Full list: Run bun start --help to see all 35+ connectors
Documentation
- Writing Connectors - How to write a connector
- Running Locally - Detailed setup and configuration
License
Apache 2.0 - see LICENSE
Inspiration
"Everything is just fetch wrapped in a function, delivered in pure typescript."
The typing in this package is heavily inspired by the AI SDK by Vercel and the development process has been influenced by the work of Sam at Alchemy.