mcp-tools-server

Small remote MCP server for course experiments with Model Context Protocol

The project exposes custom MCP tools over Streamable HTTP

Current implementation contains a GitHub-related tool that reads recent commits from a public repository

Current tools

get_recent_commits

Returns recent commits from a public GitHub repository

Input parameters:

• owner — GitHub repository owner, for example JetBrains
• repo — GitHub repository name, for example kotlin
• limit — number of commits to return, from 1 to 10

Example input:

{
  "owner": "JetBrains",
  "repo": "kotlin",
  "limit": 3
}

The tool calls the public GitHub REST API and returns a short text summary with commit SHA, message, author, date and URL

echo

Simple test tool that returns the input text back to the client

Used to verify that MCP tool calls work

Endpoints

GET /

Health-check endpoint

Example response:

{
  "service": "mcp-tools-server",
  "status": "ok",
  "tools": ["echo", "get_recent_commits"]
}

POST /mcp

MCP endpoint for Streamable HTTP clients

Run locally

Install dependencies:

npm install

Start development server:

npm run dev

Build project:

npm run build

Start compiled version:

npm start

By default the server runs on port 3000

Local MCP endpoint:

http://localhost:3000/mcp

Test with MCP Inspector

Start the server:

npm run dev

Run MCP Inspector:

npx @modelcontextprotocol/inspector

Use the following settings:

Transport Type: Streamable HTTP
URL: http://localhost:3000/mcp

Then open the Tools tab, list available tools and run get_recent_commits

Notes

Current limitations:

• only public GitHub repositories are supported;
• GitHub requests are unauthenticated;
• unauthenticated GitHub API rate limits apply;
• the server currently exposes read-only tools only.