MCP服务器工具

一个基于FastMCP框架的本地MCP服务器,提供骰子滚动和数字相加等基础工具功能,适用于Claude Desktop集成。

  • by Lnxtanx
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Lnxtanx/demo-mcp-server

使用说明

演示MCP服务器

由Vivek创建的我的第一个本地MCP(模型上下文协议)服务器项目。

概述

这是一个使用FastMCP构建的简单MCP服务器,为Claude Desktop提供基本的实用工具。它展示了创建和部署本地MCP服务器的基本原理。

特点/功能

服务器提供两种主要工具:

🎲 掷骰子

  • 功能: roll_dice(n_dice: int = 1)
  • 描述掷N个六面骰子,并返回结果
  • 使用非常适合游戏、随机数生成或决策制定

➕ 添加数字

  • 功能: add_numbers(a: float, b: float)
  • 描述把两个数相加
  • 使用方法简单的算术运算

安装

  1. 安装UV(如尚未安装):

    powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
    
  2. 将服务器安装到Claude桌面版:

    uv run --with fastmcp fastmcp install claude-desktop main.py --name "Demo Server"
    

发展

以开发模式运行服务器:

uv run --with fastmcp fastmcp dev main.py

在Claude桌面版中的使用

安装完成后,您可以直接在Claude桌面版中使用这些工具:

  • “帮我掷3个骰子”
  • “将15.5和23.7相加”

项目结构

first_local_server/
├── main.py          # Main MCP server implementation
├── pyproject.toml   # Project configuration
└── README.md        # This file

关于

这个项目是为了作为学习练习而创建的,旨在理解:

  • MCP(模型上下文协议)基础
  • FastMCP框架的使用
  • 本地服务器开发与部署
  • 与Claude桌面版的集成

由……创建维维克
项目类型首个MCP服务器
框架FastMCP
日期2025年10月