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

Related MCP server: Notion MCP Server

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

# GitHub Personal Access Token
GITHUB_TOKEN=your_github_token_here

# Notion API Key
NOTION_API_KEY=your_notion_api_key_here

# Notion Database ID
NOTION_DATABASE_ID=your_database_id_here

# Node environment
NODE_ENV=development

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

npm run dev

Production Mode

npm run build
npm start

Docker

# Build and run
docker-compose up --build

# Run in background
docker-compose up -d

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

curl -X POST http://localhost:3000/webhook/github \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Test Issue",
    "body": "This is a test issue",
    "number": 123
  }'

📁 Project Structure

MCP/
├── src/
│   ├── tools/
│   │   ├── github.ts      # GitHub API integration
│   │   └── notion.ts      # Notion API integration
│   ├── index.ts           # Main server file
│   └── workflow.ts        # GitHub issue handling
├── dist/                  # Compiled JavaScript
├── Dockerfile            # Docker configuration
├── docker-compose.yml    # Docker Compose setup
├── tsconfig.json         # TypeScript configuration
└── package.json          # Dependencies and scripts

🤝 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