mcp-server

#MCP Server

Production-ready TypeScript Model Context Protocol (MCP) server exposing utility, GitHub, and Microsoft Teams tools over stdio.

Why this repository

• Clean MCP server baseline for internal automation and integrations

• GitHub and Microsoft Teams operational tooling in a single service

• Strict TypeScript setup and minimal runtime surface

Feature overview

Utility

• echo

• get_time

GitHub tools

• github_status

• github_authenticated_user

• github_list_repos

• github_create_issue

• github_list_issues

• github_get_file

• github_create_pull_request

• github_request

Microsoft Teams tools

• teams_send_message (webhook)

• teams_send_card (adaptive card webhook)

• teams_graph_status (Graph API)

• teams_send_dm (Graph API)

Requirements

• Node.js 20+

• npm 10+

Quick start (Windows)

cd mcp-server
npm install
copy .env.example .env

Populate .env before running.

Environment variables

Required for GitHub tools

• GITHUB_TOKEN

Optional for Teams webhook tools

• TEAMS_WEBHOOK_URL

Optional for Teams Graph tools

• TEAMS_TENANT_ID

• TEAMS_CLIENT_ID

• TEAMS_CLIENT_SECRET

Scripts

• npm run dev — development mode with tsx

• npm run build — compile to dist/

• npm run start — run compiled server

• npm run clean — remove dist/

• npm run inspect — open MCP inspector

Run modes

Development:

npm run dev

Build + run:

npm run build
npm run start

MCP stdio command:

node dist/index.js

Security and compliance

• Do not commit .env or secrets

• Use least-privilege credentials for GitHub and Microsoft Graph

• Review SECURITY.md before production use

Contributing

See CONTRIBUTING.md and CODE_OF_CONDUCT.md.

License

Distributed under the MIT License. See LICENSE.