Simple MCP Servers

シンプルな MCP サーバー

Python で書かれた、1 ファイル構成の MCP サーバーを格納するリポジトリです。

概要

このリポジトリには、Claude Desktop やその他の MCP 互換アプリケーションに簡単に統合できる、自己完結型の単一ファイル MCP（Model Context Protocol）サーバーが含まれています。各サーバーは単独で動作するように設計されており、依存関係は 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

単語ゲームアプリケーション向けに、SOWPODS の完全な単語リストを収録した Scrabble の単語検証サーバーです。

インストールと使用方法

前提条件

• 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 - 詳細については LICENSE ファイルを参照してください。

作者

Joshua Shew（2025）