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

start_price_watch

Starts periodic price monitoring for a market symbol and stores snapshots in JSON

Input:

• symbol — market symbol, for example BTCUSDT
• intervalSeconds — collection interval in seconds, from 10 to 3600

get_price_watch_summary

Returns an aggregated summary for collected price snapshots

Summary includes:

• snapshots count
• first and last price
• min and max price
• average price
• absolute and percentage change
• recent snapshots

stop_price_watch

Stops periodic price monitoring for a market symbol and removes stored watch state

echo

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

Used to verify that MCP tool calls work

Storage

Price watch data is stored locally in:

storage/price-watch-state.json

The file is created at runtime and is not committed to Git

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;
• the price watcher uses an in-process setInterval scheduler and JSON file storage. Locally it works while the Node.js process is running.