Paws-on-MCP
A comprehensive Model Context Protocol (MCP) server implementing the latest MCP specification with tools, resources, prompts, and enhanced sampling capabilities that features HackerNews and GitHub API integrations for AI-powered analysis.
What is Paws-on-MCP?
Paws-on-MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to comprehensive model context protocol (mcp) server implementing the latest mcp specification with tools, resources, prompts, and enhanced sampling capabilities that features hackernews and github api i...
A comprehensive Model Context Protocol (MCP) server implementing the latest MCP specification with tools, resources, prompts, and enhanced sampling capabilities that features HackerNews and GitHub API integrations for AI-powered analysis.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A comprehensive Model Context Protocol (MCP) server implemen
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx paws-on-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Paws-on-MCP
Paws-on-MCP is a feature-complete reference implementation of the Model Context Protocol specification, exposing nine tools that cover HackerNews story search, GitHub repository metadata retrieval, AI-powered trend analysis, automated code review via sampling, and client filesystem access through server roots. It runs as a local Python server on http://127.0.0.1:8000/mcp/ and is designed both as a hands-on learning resource for the MCP spec and as a practical integration hub for developer data sources. Teams and individual developers use it to explore advanced MCP features like enhanced sampling with model preferences and prompt templating in a single, well-structured server.
Prerequisites
- Python 3.10 or higher installed
- pip for installing Python dependencies
- An MCP-compatible client such as Claude Desktop
- Git to clone the repository
Clone the repository
Download the source code from GitHub to your local machine.
git clone https://github.com/hemanth/paws-on-mcp.git
cd paws-on-mcpInstall Python dependencies
Install all required packages listed in requirements.txt, including the MCP SDK and any API client libraries.
pip install -r requirements.txtStart the MCP server
Launch the server from the src directory. It starts on http://127.0.0.1:8000/mcp/ and is ready to accept MCP connections.
cd src
python mcp_server.pyConfigure your MCP client
Add paws-on-mcp to your Claude Desktop configuration. Since it runs over HTTP, use the url transport option pointing to the local endpoint.
{
"mcpServers": {
"paws-on-mcp": {
"url": "http://127.0.0.1:8000/mcp"
}
}
}Test tools via the CLI client
Use the bundled CLI client to verify individual tools before connecting a GUI client. This confirms the server is responding correctly.
python mcp_cli_client.py tool search_hackernews --args '{"query": "MCP protocol", "limit": 5}'Paws-on-MCP Examples
Client configuration
Claude Desktop configuration connecting to the locally running paws-on-mcp HTTP server.
{
"mcpServers": {
"paws-on-mcp": {
"url": "http://127.0.0.1:8000/mcp"
}
}
}Prompts to try
Example prompts that exercise the nine tools paws-on-mcp exposes.
- "Search HackerNews for the top 5 stories about 'Rust programming' and summarize them."
- "Get the repository info for github.com/modelcontextprotocol/python-sdk."
- "Analyze current HackerNews trends with AI and tell me what topics are gaining traction."
- "Do an AI-powered code review of this Python function: def add(a, b): return a + b"
- "List available MCP prompt templates on this server."Troubleshooting Paws-on-MCP
Server fails to start with ModuleNotFoundError
Run pip install -r requirements.txt from the repository root before starting the server. If using a virtual environment, ensure it is activated first.
Claude Desktop cannot connect to http://127.0.0.1:8000/mcp
Confirm the server is running (the terminal should show a startup message). Check that no firewall or port conflict is blocking port 8000 — try curl http://127.0.0.1:8000/mcp to test connectivity.
create_sampling_request tool returns errors about model preferences
intelligence_priority, cost_priority, and speed_priority must all be floats between 0.0 and 1.0. Ensure the MCP client you are using supports sampling; not all clients implement this part of the spec.
Frequently Asked Questions about Paws-on-MCP
What is Paws-on-MCP?
Paws-on-MCP is a Model Context Protocol (MCP) server that comprehensive model context protocol (mcp) server implementing the latest mcp specification with tools, resources, prompts, and enhanced sampling capabilities that features hackernews and github api integrations for ai-powered analysis. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Paws-on-MCP?
Follow the installation instructions on the Paws-on-MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Paws-on-MCP?
Paws-on-MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Paws-on-MCP free to use?
Yes, Paws-on-MCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Paws-on-MCP Alternatives — Similar Developer Tools Servers
Looking for alternatives to Paws-on-MCP? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Paws-on-MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Paws-on-MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.