mcpField
M
MCP Server

MCP Server

Local
github.com/devhystericalDeveloper Tools0Updated 83w ago
Repository

About MCP Server

MCP Server is a FastAPI-based MCP implementation for exposing calculator, weather, and web-search operations. It is intended for developers who need an HTTP API for model access to external tools, with request validation and Swagger UI documentation.

Key features

  1. 01Calculator, weather, and search tools
  2. 02REST API built with FastAPI
  3. 03Request validation with Pydantic
  4. 04Asynchronous request handling
  5. 05Automatic Swagger UI documentation

Use cases

  1. 01Run arithmetic operations through a tool call
  2. 02Retrieve weather for a location
  3. 03Search the web through an API

MCP support

It implements MCP and exposes calculator, weather, and search tools for MCP clients. The tools are invoked through the `/execute` endpoint.

#mcp-server#model-context-protocol#api-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MCP Server

MCP Server là một máy chủ triển khai giao thức Model Context Protocol (MCP), cho phép các mô hình ngôn ngữ lớn (LLMs) tương tác với các công cụ và dịch vụ bên ngoài một cách chuẩn hóa.

Tính năng

  • Hỗ trợ nhiều công cụ khác nhau (calculator, weather, search)
  • API RESTful với FastAPI
  • Xác thực dữ liệu với Pydantic
  • Xử lý bất đồng bộ hiệu quả
  • Tài liệu API tự động với Swagger UI

Yêu cầu hệ thống

  • Python 3.8+
  • pip (Python package manager)

Cài đặt

  1. Clone repository:
git clone <repository-url>
cd mcp-server
  1. Tạo và kích hoạt môi trường ảo:
python -m venv venv
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate
  1. Cài đặt các thư viện cần thiết:
pip install -r requirements.txt

Chạy server

python main.py

Server sẽ chạy tại địa chỉ: http://localhost:8000

API Endpoints

1. Root Endpoint
  • URL: /
  • Method: GET
  • Description: Trả về thông tin về server và danh sách các công cụ được hỗ trợ
2. Execute Tool
  • URL: /execute
  • Method: POST
  • Description: Thực thi một công cụ với các tham số được cung cấp
  • Request Body:
{
  "tool_name": "calculator",
  "parameters": {
    "operation": "add",
    "numbers": [1, 2, 3]
  },
  "context": {}
}

Các công cụ được hỗ trợ

1. Calculator
  • Thực hiện các phép tính cơ bản
  • Tham số:
    • operation: "add" hoặc "multiply"
    • numbers: mảng các số cần tính
2. Weather
  • Lấy thông tin thời tiết cho một địa điểm
  • Tham số:
    • location: tên địa điểm
3. Search
  • Thực hiện tìm kiếm web
  • Tham số:
    • query: từ khóa tìm kiếm

Tài liệu API

Truy cập http://localhost:8000/docs để xem tài liệu API đầy đủ với Swagger UI.

Phát triển

Thêm công cụ mới
  1. Thêm tên và mô tả công cụ vào SUPPORTED_TOOLS
  2. Thêm hàm xử lý mới trong process_tool_request
  3. Tạo hàm xử lý riêng cho công cụ mới
Chạy tests
pytest

License

MIT License

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.