@kotoragk/hp-mcp

A sample MCP (Model Context Protocol) server that exposes the kotoragk HP (homepage) public API as read-only tools. It is intentionally small: a thin HTTP client that fetches the existing HP endpoints and returns the JSON to the model.

Use it as a reference for how to build and publish an MCP server in TypeScript.

Tools

Each tool calls ${HP_API_BASE_URL}/hp/... and returns the raw JSON.

Related MCP server: Online News MCP Server

Install into Claude Code

claude mcp add hp -- npx -y @kotoragk/hp-mcp

To point at a different backend (e.g. a local Django server), pass the env var:

claude mcp add hp -e HP_API_BASE_URL=http://127.0.0.1:8000 -- npx -y @kotoragk/hp-mcp

Local development

npm install
npm run build      # compiles src/ -> dist/
npm start          # runs dist/index.js on stdio

The server speaks the MCP protocol over stdio, so running it directly just waits for a client. Use an MCP client (Claude Code, the MCP Inspector, etc.) to interact with it.

Publish

npm login
npm publish --access public