Simple MCP Servers

简易 MCP 服务

用于存放以 Python 编写的单文件 MCP 服务的仓库

概述

此仓库包含自包含的单文件 MCP（Model Context Protocol）服务，可轻松集成到 Claude Desktop 或其他兼容 MCP 的应用程序中。每个服务都设计为独立运行，并使用 PEP 723 内联脚本元数据声明依赖项。

功能

• 自包含脚本 - 每个 MCP 服务都是一个内嵌依赖项的 Python 文件
• 符合 PEP 723 - 使用内联脚本元数据管理依赖项
• 直接执行 - 可使用 uv 直接运行脚本，也可将其作为独立程序执行
• 无需设置 - 运行时由 uv 自动处理依赖项

可用的 MCP 服务

1. deer_to_bsky.py

将 deer.social URL 转换为兼容 Bluesky 的 AT URI 格式，以便与 Bluesky 工具无缝集成。

2. large_file_reader_mcp.py

提供高效的大文件分块读取方法，包括按行读取、读取开头或结尾内容、按字节访问，以及带上下文的模式搜索。

3. time_god_mcp.py

一个 Scrabble 单词验证服务，包含适用于文字游戏应用的完整 SOWPODS 单词列表。

安装与使用

前提条件

• Python >= 3.11
• uv 包管理器

运行服务

每个服务都可以通过多种方式运行：

方法 1：直接执行（如果具有可执行权限）

./deer_to_bsky.py

方法 2：使用 uv

uv run --script deer_to_bsky.py

Claude Desktop 配置

将任意服务添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "deer-to-bsky": {
      "command": "/path/to/uv",
      "args": [
        "run",
        "--script",
        "/path/to/deer_to_bsky.py"
      ]
    }
  }
}

开发

创建新的 MCP 服务

1. 从 PEP 723 标头开始：

#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.11"
# dependencies = [
#     "fastmcp",
#     "pydantic"
# ]
# ///

2. 遵循现有的结构和文档编写模式
3. 将文件设为可执行：chmod +x your_server_mcp.py

依赖项

所有服务都使用：

• fastmcp - MCP 框架
• pydantic - 数据验证

依赖项使用 PEP 723 格式内联声明，因此无需 requirements.txt 或其他外部依赖项文件。

Claude 说明

详细的协作说明和开发指南请参阅 CLAUDE.md。

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件

作者

Joshua Shew（2025）