Skip to content

neilthomass/ContextConnect

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Integration Snippets

A modern integration snippets platform that provides API integration code snippets through two interfaces: a web application wand an MCP (Model Context Protocol) server for AI assistants and automated tools.

Two Usage Options

1. Web Application Mode

A browser-based interface for manually browsing and copying integration snippets.

Features:

  • Dynamic Search: Real-time search across vendors and topics
  • Copy to Clipboard: One-click copying of integration code snippets
  • Responsive Design: Optimized for desktop and mobile devices
  • Visual Interface: Click-to-browse integration library

2. MCP Server Mode

A Model Context Protocol server that provides integration snippets as a structured service for AI assistants and automated tools.

Features:

  • Programmatic Access: Query integration data via MCP protocol
  • AI Assistant Integration: Compatible with Claude and other MCP-enabled tools
  • Automation Support: Integrate snippets into development workflows
  • Structured Data: JSON-formatted integration metadata and code

Common Features (Both Modes)

  • Modular Architecture: Each integration is self-contained with its own metadata
  • Code Syntax Highlighting: Proper highlighting for JavaScript and bash code blocks
  • Dynamic Content: Loads integration data from GitHub repository

Setup Instructions

Prerequisites

  • Node.js (version 14 or higher)
  • npm
  • Git

Installation

  1. Clone the repository

    git clone https://github.com/yourusername/inte.git
    cd inte
  2. Install root dependencies and build MCP

    npm install
    npm run build
    cd web
    npm install
    cd ..

Running the Application

Choose one of the two modes based on your needs:

Option 1: Web Application Mode

Use when: You want to browse integrations visually, copy-paste code manually, or explore available integrations through a user-friendly interface.

  1. Start the web development server

    cd web
    npm run dev
  2. Access the application Open your browser and navigate to http://localhost:3000

Option 2: MCP Server Mode

Use when: You want AI assistants to access integration data, you're building automated tools, or you need programmatic access to integration snippets.

Start the MCP server

node build/index.js

OR

Connect your MCP-enabled tool The server will be available for MCP protocol connections following is how to use the config json for claude and cursor. Make sure to use absolute path.

 {
 "mcpServers": {
     "inte": {
     "command": "node",
     "args": ["/Users/YOURUSERNAME/inte/build/index.js"],
     "tools": [],
     "resources": ["listVendors", "getSnippet"],
     "description": "MCP server serving API integration snippets for various vendors and languages",
     "enabled": true,
     "category": "development"
     }
 }
 }

When to Use Each Mode

Feature Web Mode MCP Server Mode
Interface Browser UI API/Protocol server
Target User Human developers AI assistants/tools
Access Method Visual browsing Programmatic queries
Best For Manual exploration Automated workflows

Usage

Adding New Integrations

  1. Create a new folder in the snippets/ directory with your integration name
  2. Add metadata.json with the following structure:
    {
      "vendorName": "YourService",
      "language": "JavaScript",
      "topics": ["api", "integration", "service"],
      "lastUpdated": "2025-01-15",
      "slug": "yourservice"
    }
  3. Add snippet.md with your integration code and documentation
  4. Update the main metadata.json file in the snippets root director
  5. Push to Github

Technology Stack

Web Application:

  • Frontend: Next.js with React
  • Styling: CSS-in-JS with styled-jsx
  • Markdown: ReactMarkdown for content rendering

MCP Server:

  • Protocol: Model Context Protocol
  • Runtime: Node.js
  • Data Format: JSON metadata with Markdown content

About

API integration via web app and Model Context Protocol server for humans, AI assistants, and automated tools.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors