使用说明
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服务器提供两个入口点:
mcp_simple_server-server:处理工具请求的MCP服务器当使用SSE传输运行时,您也可以使用curl ping服务器。请看 这个脚本.# Run with stdio transport (default) mcp_simple_server-server # Run with SSE transport mcp_simple_server-server --transport sse
日志记录
服务器将所有活动记录到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
- Root用户:
- 视窗:
%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
有效的日志级别为:调试、信息(默认)、警告、错误、临界
mcp_simple_server-client:方便测试的客户端mcp_simple_server-client "your command here"
需求
- Python 3.11或更高版本(<3.13)
- 操作系统:Linux、macOS、Windows
配置
全部
发展
看 Developpent.md 详细的开发说明。
许可证
该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。
作者
- 尼科洛·西利卡尼
