hp-mcp
Exposes the kotoragk homepage public API as read-only tools, enabling users to fetch news, company info, and news details via natural language.
README
@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
| Tool | Arguments | Description |
|---|---|---|
get_news |
page? (number) |
News (お知らせ) list with count and categories |
get_news_detail |
newsnumber (number) |
A single news article, with prev/next links |
get_company |
— | Company (会社情報) profile |
Each tool calls ${HP_API_BASE_URL}/hp/... and returns the raw JSON.
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
| Env var | Default | Description |
|---|---|---|
HP_API_BASE_URL |
https://kotoragk.com |
Base URL of the HP API (no trailing /hp) |
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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
Neon Database
MCP server for interacting with Neon Management API and databases
E2B
Using MCP to run code via e2b.
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.