MCP服务器

一个简单的MCP服务器项目,用于处理工具请求并提供客户端测试功能。

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

使用说明

mcp简单服务器

MCP服务器

概述

熟悉MCP的简单项目

特性

全部

安装

来自PyPI(如果已发布)

如果服务器发布在PyPI上,有两种主要的使用方法:

选项1:安装然后运行(建议经常使用)

首先,使用UV将包安装到Python环境中:

# Install using UV
uv pip install mcp_simple_server

# If you don't have UV, you can use pip:
# pip install mcp_simple_server

安装后,您可以从终端运行服务器:

mcp_simple_server-server

选项2:直接运行 uvx (无需永久安装即可快速使用)

如果您想在不将其安装到当前环境的情况下运行服务器(或轻松运行特定版本),可以使用 uvx。这对于一次性任务或测试非常方便。

# Run the latest version of the server directly from PyPI
uvx mcp_simple_server mcp_simple_server-server

# You can also specify a version:
# uvx mcp_simple_server==1.2.3 mcp_simple_server-server

这个命令告诉 uvx 取 mcp_simple_server 打包并执行其 mcp_simple_server-server 命令。

来源

# Clone the repository
git clone <your-repository-url>
cd mcp_simple_server

# Create and activate a virtual environment using UV
uv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install in development mode using UV
uv pip install -e .

可用工具

工具名称

全部

例子:

# Using stdio transport (default)
mcp_simple_server-client "your command here"

# Using SSE transport
mcp_simple_server-server --transport sse
curl http://localhost:3001/sse

用法

此MCP服务器提供两个入口点:

  1. mcp_simple_server-server:处理工具请求的MCP服务器
    # Run with stdio transport (default)
    mcp_simple_server-server
    
    # Run with SSE transport
    mcp_simple_server-server --transport sse
    
    当使用SSE传输运行时,您也可以使用curl ping服务器。请看 这个脚本.

日志记录

服务器将所有活动记录到stderr和旋转日志文件中。日志文件存储在操作系统特定的位置:

  • macOS: ~/Library/Logs/mcp-servers/mcp_simple_server.log
  • Linux:
    • Root用户: /var/log/mcp-servers/mcp_simple_server.log
    • 非根: ~/.local/state/mcp-servers/logs/mcp_simple_server.log
  • 视窗: %USERPROFILE%\AppData\Local\mcp-servers\logs\mcp_simple_server.log

日志文件达到10MB时会自动轮换,最多保留5个备份文件。

您可以使用配置日志级别 LOG_LEVEL 环境变量:

# Set log level to DEBUG for more detailed logging
LOG_LEVEL=DEBUG mcp_simple_server-server

有效的日志级别为:调试、信息(默认)、警告、错误、临界

  1. mcp_simple_server-client:方便测试的客户端
    mcp_simple_server-client "your command here"
    

需求

  • Python 3.11或更高版本(<3.13)
  • 操作系统:Linux、macOS、Windows

配置

全部

发展

看 Developpent.md 详细的开发说明。

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。

作者

  • 尼科洛·西利卡尼