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