MCP Server

MCP (Model Context Protocol) Server

A Node.js/TypeScript server that implements the Model Context Protocol with integrations for GitHub and Notion.

🚀 Features

• Express.js Server with TypeScript support
• GitHub Integration using Octokit REST API
• Notion Integration for task management
• Docker Support for containerized deployment
• Webhook Endpoints for GitHub event handling

📋 Prerequisites

• Node.js 18+
• Docker (optional)
• GitHub Personal Access Token
• Notion API Key and Database ID

🛠️ Installation

1. Clone the repository
   git clone <your-repo-url> cd MCP
2. Install dependencies
   npm install
3. Set up environment variables
   cp env.example .env # Edit .env with your API keys
4. Build the project
   npm run build

🔧 Configuration

Environment Variables

Create a .env file with the following variables:

API Keys Setup

1. GitHub Token:
   • Go to https://github.com/settings/tokens
   • Create a new token with repo scope
2. Notion Integration:
   • Go to https://www.notion.so/my-integrations
   • Create a new integration
   • Share your database with the integration

🏃‍♂️ Running the Application

Development Mode

Production Mode

Docker

📡 API Endpoints

• GET / - Health check endpoint
• POST /webhook/github - GitHub webhook handler

🛠️ Available Tools

GitHub Tools (src/tools/github.ts)

• createIssueComment() - Post comments on GitHub issues
• getIssue() - Get issue details
• listIssues() - List repository issues

Notion Tools (src/tools/notion.ts)

• createTaskInNotion() - Create tasks in Notion database
• getPage() - Get page details
• getDatabase() - Get database structure
• queryDatabase() - Query database

🧪 Testing

Test the webhook endpoint:

📁 Project Structure

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

📄 License

This project is licensed under the ISC License.

🔗 Links

• Model Context Protocol
• GitHub REST API
• Notion API
• Express.js
• TypeScript