Hello MCP Nc5

🚀 Hello-MCP Protocol

This project offers a simple implementation of the Model Control Protocol (MCP), helping you understand how the MCP works.

🚀 Quick Start

The Hello-MCP project provides a straightforward implementation of the MCP protocol. It allows you to quickly understand and start using the MCP protocol for AI model interaction.

✨ Features

Introduction to MCP Protocol

• Standardized AI model interaction protocol.
• Unified tool invocation specifications.
• Simplified integration of complex AI systems.
• Support for multi - model collaboration platforms.

Project Features

Client Features

• Interactive command - line chat interface.
• Support for MCP tool registration and discovery.
• Integration of DeepSeek API.

Server Features

• Basic MCP protocol implementation.
• Support for custom tool extensions.
• Built - in example tool set.

📦 Installation

1. Clone the project repository:

git clone https://github.com/yourusername/hello-mcp.git
cd hello-mcp

2. Create a virtual environment and install dependencies:

python -m venv env
source env/bin/activate  # For Mac/Linux or env\Scripts\activate.bat for Windows
pip install -r requirements.txt

Configuration File

Edit the config.yaml file and fill in the following information:

• API access key: The API key obtained from DeepSeek.

Start the Service

uvicorn server:app --reload

💻 Usage Examples

Basic Usage

Register an MCP tool:

from mcp.client import MCPClient

client = MCPClient()
client.register_tool('tool_name', 'http://localhost:8000')

📚 Documentation

Debugging Tips

1. Check the service startup log to confirm that the API interface is running properly.
2. Use the curl command to test the API interface:

curl http://localhost:8000/docs

MCP Protocol Q&A

What is the MCP Protocol?

• Question 1: What problems does MCP solve?
  • Standardize AI model interaction protocols.
  • Unify tool invocation specifications.
  • Simplify the integration of complex AI systems.
  • Support multi - model collaboration.
• Question 2: What is the development history of MCP?
  • 2023: Proposed by Anthropic.
  • 2024: Open - source implementations started to gain popularity.
  • 2025: Became a de - facto standard.
  • Now: Widely used in AI system integration.

Differences between MCP and Function Calls

Common Project Issues

Configuration Issues

1. Incorrect DeepSeek API configuration?
   • Check if the api_key in config.yaml is filled in correctly.
2. Incorrect API key format?
   • Ensure there are no extra spaces or quotes.
   • Try regenerating the API key.

Service Startup Issues

1. Port is occupied?

lsof -i :8000    # Check the occupied process
kill -9 PID       # Kill the process and restart the service

2. Modify the default port? Modify the app = FastAPI(...) configuration in server.py.

Project Extension Development

Add a New Tool

@app.post("/tool/{tool_name}")
async def handle_tool(tool_name: str, request_data: dict):
    # Implement custom logic

Contribution Guidelines

1. Fork this repository.
2. Create a feature branch.
3. Commit your code.
4. Create a Pull Request.

Welcome to participate in the project development through Issues or Pull Requests!