최신 MCP 2025-03-26 사양을 구현한 포괄적인 모델 컨텍스트 프로토콜(MCP) 서버. 도구, 리소스, 프롬프트, 루트, 모델 선호도에 따른 향상된 샘플링 등 MCP 기능을 시연합니다. 기능: 고급 MCP 샘플링을 통한 AI 기반 분석과 결합된 HackerNews 및 GitHub API 통합.

🎯 현재 상태

** ✅ 운영 준비 핵심 기능 (3/5 테스트 스위트 통과)**

• MCP 툴스 (9/9) - 향상된 샘플링을 포함해 모든 도구가 완벽하게 작동합니다
• MCP 리소스 (2015년 15월) - 모든 리소스가 완벽하게 작동합니다
• MCP 프롬프트 (14/14) - 모든 프롬프트 템플릿이 완벽하게 작동합니다
• MCP 프로토콜 준수 - 전체 MCP 2025-03-26 사양 지원
• 향상된 샘플링 - 모델 선호도와 맥락 인식 샘플링 작동

** ⚠️ 알려진 한계 사항**

• MCP 루츠 - 프레임워크 동시성 제한 (기능 정상, 테스트 인프라 문제)
• 향상된 샘플링 테스트 - 부하 테스트 시 서버 동시성 제약

핵심 MCP 기능은 완전히 운영 가능하며 운영 준비가 완료되었습니다.

📁 프로젝트 구조

🚀 퀵 스타트

설치

MCP SDK와 의존성 설치:

서버 운영

Paws-on-MCP: Unified MCP Server Implementation 🐾

A comprehensive Model Context Protocol (MCP) server implementing the latest MCP 2025-03-26 specification. Demonstrates MCP capabilities including tools, resources, prompts, roots, and enhanced sampling with model preferences. Features HackerNews and GitHub API integrations with AI-powered analysis through advanced MCP sampling.

🎯 Current Status

✅ Production-Ready Core Features (3/5 test suites passing)

• MCP Tools (9/9) - All tools working perfectly including enhanced sampling
• MCP Resources (15/15) - All resources working perfectly
• MCP Prompts (14/14) - All prompt templates working perfectly
• MCP Protocol Compliance - Full MCP 2025-03-26 specification support
• Enhanced Sampling - Model preferences and context-aware sampling working

⚠️ Known Limitations

• MCP Roots - Framework concurrency limitations (functionality works, test infrastructure issues)
• Enhanced Sampling Tests - Server concurrency constraints under load testing

The core MCP functionality is fully operational and production-ready.

📁 Project Structure

paws-on-mcp/
├── src/                      # Source code
│   ├── mcp_server.py         # Main MCP server (MCP 2025-03-26)
│   └── mcp_cli_client.py     # CLI client for testing
├── tests/                    # Comprehensive test suite
│   ├── run_tests.py          # Complete test runner
│   ├── test_mcp_tools.py     # Tools functionality tests
│   ├── test_mcp_resources.py # Resources tests  
│   ├── test_mcp_prompts.py   # Prompts tests
│   ├── test_mcp_roots.py     # Roots tests (MCP 2025-03-26)
│   └── test_enhanced_sampling.py # Enhanced sampling tests
├── docs/                     # Documentation
│   ├── architecture.md       # Technical architecture
│   ├── blog.md              # Development insights  
│   └── CLI_README.md         # CLI usage guide
├── requirements.txt          # Python dependencies
└── README.md                 # This file

Installation

Install the MCP SDK and dependencies:

# Using pip
pip install -r requirements.txt

Running the Server

Start the comprehensive MCP server:

cd src
python mcp_server.py

The server will start on http://127.0.0.1:8000/mcp/ with the following startup message:

🚀 Starting Unified MCP Server on http://127.0.0.1:8000/mcp/
📋 Available features:
   • HackerNews integration (resources & tools)
   • GitHub repository discovery
   • Server-side sampling with roots capability
   • Tech trends analysis prompts
💡 Use Ctrl+C to stop the server

Comprehensive Testing

Run the complete test suite:

# Run all organized tests
cd tests
python run_tests.py

Expected Test Results:

============================================================
📊 COMPREHENSIVE TEST RESULTS SUMMARY
============================================================