js-bambisleep-chat-mcp-server

HarleyVader/js-bambisleep-chat-mcp-server

3.1

If you are the rightful owner of js-bambisleep-chat-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A comprehensive Model Context Protocol (MCP) server with GitHub integration and OAuth authentication.

MCP Server & Agent Docking System

A comprehensive Model Context Protocol (MCP) server with GitHub integration and OAuth authentication.

Quick Start

  1. Clone and setup:

    git clone https://github.com/HarleyVader/js-bambisleep-chat-mcp-server.git
cd js-bambisleep-chat-mcp-server
npm install

  2. Configure environment:

    cp .env.example .env
# Edit .env with your OAuth credentials and settings

  3. Start development:

    npm run dev

Project Structure

js-bambisleep-chat-mcp-server/
ā”œā”€ā”€ server/                 # MCP Server implementation
ā”‚   ā”œā”€ā”€ src/
ā”‚   ā”‚   ā”œā”€ā”€ auth/          # OAuth strategies and session management
ā”‚   ā”‚   ā”œā”€ā”€ mcp/           # MCP protocol implementation
ā”‚   ā”‚   ā”œā”€ā”€ routes/        # Express routes
ā”‚   ā”‚   ā”œā”€ā”€ models/        # Database models
ā”‚   ā”‚   ā””ā”€ā”€ app.js         # Main server entry point
ā”‚   ā”œā”€ā”€ tests/
ā”‚   ā””ā”€ā”€ package.json
ā”œā”€ā”€ agent/                 # Agent for GitHub integration
ā”‚   ā”œā”€ā”€ src/
ā”‚   ā”‚   ā”œā”€ā”€ github/        # GitHub API integration
ā”‚   ā”‚   ā”œā”€ā”€ git/           # Git operations
ā”‚   ā”‚   ā””ā”€ā”€ agent.js       # Main agent entry point
ā”‚   ā”œā”€ā”€ tests/
ā”‚   ā””ā”€ā”€ package.json
ā”œā”€ā”€ shared/                # Shared utilities and types
ā”œā”€ā”€ docker/                # Docker configurations
ā”œā”€ā”€ .env.example
ā”œā”€ā”€ docker-compose.yml
ā”œā”€ā”€ package.json           # Root package.json for monorepo
ā””ā”€ā”€ README.md

Features

  • MCP Protocol Support: Full implementation of Model Context Protocol
  • OAuth Authentication: GitHub and Patreon integration
  • GitHub Integration: Automated PR creation and repository management
  • Real-time Communication: WebSocket and SSE support
  • Tool Management: Dynamic tool registration and execution
  • Docker Support: Complete containerization

Development

Scripts

  • npm run dev - Start both server and agent in development mode
  • npm run build - Build all workspaces
  • npm run test - Run tests across all workspaces
  • npm run lint - Lint all code
  • npm run format - Format code with Prettier

Environment Setup

Copy .env.example to .env and configure:

  1. GitHub OAuth: Create OAuth app in GitHub settings
  2. Patreon OAuth: Create OAuth app in Patreon developer console
  3. Database: Configure your preferred database
  4. Session: Generate secure session secret

Architecture

The system consists of three main components:

  1. Server: Express-based MCP server with OAuth and real-time communication
  2. Agent: GitHub integration service for automated repository operations
  3. Shared: Common utilities and type definitions

Contributing

  1. Create feature branch
  2. Make changes with tests
  3. Ensure lint/format passes
  4. Submit pull request

License

MIT