Freedanfan MCP Server

🚀 MCP Server

This project, built on FastAPI and MCP (Model Context Protocol), enables standardized context interaction between AI models and development environments. By simplifying model deployment, providing efficient API endpoints, and ensuring consistency in input and output, it enhances the scalability and maintainability of AI applications, making it easier for developers to integrate and manage AI tasks.

🚀 Quick Start

The MCP (Model Context Protocol) is a unified context interaction protocol between AI models and development environments. This project offers a Python-based implementation of the MCP server, supporting basic MCP protocol functions such as initialization, sampling, and session management.

✨ Features

• JSON-RPC 2.0: Request - response communication based on the standard JSON - RPC 2.0 protocol.
• SSE Connection: Supports Server - Sent Events (SSE) connections for real - time notifications.
• Modular Design: Adopts a modular architecture for easy expansion and customization.
• Asynchronous Processing: Implements high - performance services using FastAPI and asynchronous IO.
• Complete Client: Includes a comprehensive test client implementation.

📦 Project Structure

mcp_server/
├── mcp_server.py         # Main program of the MCP server
├── mcp_client.py         # Test program of the MCP client
├── routers/
│   ├── __init__.py       # Initialization of the router package
│   └── base_router.py    # Implementation of the basic router
├── requirements.txt      # Project dependencies
└── README.md             # Project documentation

📦 Installation

1. Clone the repository:

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

2. Install the dependencies:

pip install -r requirements.txt

💻 Usage Examples

Basic Usage

Server Startup

Run the mcp_server.py script to start the MCP server:

python mcp_server.py

By default, the server will run on port 8000. You can customize the host and port through the environment variables MCP_SERVER_HOST and MCP_SERVER_PORT.

Client Usage

After configuring the server address and other parameters in mcp_client.py, you can call relevant functions. For example:

from mcp_client import MCPClient

client = MCPClient(server_url="http://localhost:8000")
response = client.request("command", parameters)
print(response)

📚 Documentation

Refer to the docs directory in the project repository for detailed documentation, including API references, usage guides, and development instructions.

📄 License

This project is open - source under the MIT License. See the LICENSE file for detailed information.