mcp-connectors

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

• 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

The connectors can be imported and used in your own MCP server implementations.

Getting Started (First Time Setup)

If you want to run the connectors locally or contribute to the project:

1. Clone the repository:

   git clone https://github.com/stackone-ai/mcp-connectors.git
   cd mcp-connectors
   

2. Install Bun (if you don't have it already):

   curl -fsSL https://bun.sh/install | bash
   

3. Install dependencies:

   bun install
   

4. Build the project:

   bun run build
   

5. Run the tests:

   bun test
   

6. 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

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 package

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.

Built by StackOne • Powers disco.dev