Skip to main content
Glama
deenesjakoruzh
YoshiLoL0526

mcp-toolkit

by YoshiLoL0526
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

mcp-toolkit

AIエージェント向けの汎用MCPサーバー。 Python 3.13、FastMCP、Playwrightで構築されています。

利用可能なツール

ツール

説明

web_search

DuckDuckGoで検索し、PlaywrightでWebコンテンツを抽出する

fetch_url

直接URLから主要なコンテンツを抽出する

http_request

Playwrightを使用せずに汎用的なHTTPリクエストを実行する

time_now

指定したタイムゾーンの現在の日時を返す

date_utils

タイムゾーンの変換や日付・期間の計算を行う

memory_set

SQLiteに永続的な値を保存する

memory_get

保存された値を取得する

memory_delete

キーを削除する

memory_list

すべてのキーをリスト表示する（オプションでプレフィックスによるフィルタリングが可能）

memory_clear

メモリ全体を消去する（元に戻せません！）

memory_search

保存されたキーと値からテキストを検索する

run_python

タイムアウト付きのサンドボックスでPythonコードを実行する

run_js

タイムアウト付きのサンドボックスでNode.jsを使用してJavaScriptコードを実行する

Related MCP server: MCP Server

インストール

前提条件

  • UV がインストールされていること

  • Python 3.13 (インストールされていない場合、UVが自動的にダウンロードします)

  • Node.js (オプション、run_jsを使用する場合のみ)

オプションA — ローカルフォルダからインストール

git clone https://github.com/YoshiLoL0526/mcp-toolkit
cd mcp-toolkit
uv tool install --python 3.13 .

オプションB — GitHubから直接インストール

uv tool install --python 3.13 git+https://github.com/YoshiLoL0526/mcp-toolkit

必須ステップ: Playwright用のChromiumをインストール

パッケージをインストールした後、このコマンドを一度だけ実行してください:

# Obtener la ruta del entorno virtual creado por uv tool
uv tool run --from mcp-toolkit python -m playwright install chromium

または、環境のパスがわかっている場合は以下を実行してください:

~/.local/share/uv/tools/mcp-toolkit/bin/python -m playwright install chromium

MCPクライアントでの設定

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)

{
  "mcpServers": {
    "mcp-toolkit": {
      "command": "mcp-toolkit"
    }
  }
}

Windowsの場合、パスは %APPDATA%\Claude\claude_desktop_config.json です

Cursor / VS Code (.cursor/mcp.json または .vscode/mcp.json)

{
  "servers": {
    "mcp-toolkit": {
      "type": "stdio",
      "command": "mcp-toolkit"
    }
  }
}

HTTPサーバー (リモートアクセスや複数のクライアント用)

mcp-toolkit --transport http --host 0.0.0.0 --port 8080

サーバーは streamable-http トランスポート（現在のMCP標準）を使用して http://<host>:<port>/mcp で待機します。--path /別のパス でパスを変更できます。

--transport sse トランスポートは古いクライアントとの互換性のために維持されていますが、FastMCP 2.3以降は非推奨です。

ツールの使用方法

web_search

Parámetros:
  query        (str)  — texto a buscar
  max_results  (int)  — resultados a devolver, default 5, máximo 10
  deep         (bool) — si True, extrae el contenido completo de cada página
  language     (str)  — idioma para las cabeceras HTTP, default "es-ES"

例 (エージェント):

Busca las últimas noticias sobre Python 3.13 con deep=True

fetch_url

Parámetros:
  url (str) — URL absoluta HTTP o HTTPS a leer

例 (エージェント):

Lee https://example.com/articulo con fetch_url

http_request

Parámetros:
  method  (str)  — método HTTP: GET, POST, PUT, PATCH, DELETE, HEAD u OPTIONS
  url     (str)  — URL absoluta HTTP o HTTPS
  headers (dict) — cabeceras opcionales
  body    (str)  — cuerpo opcional como texto
  timeout (int)  — segundos máximos, default 10, máximo 60

例 (エージェント):

Haz un POST a https://api.example.com/items con http_request

time_now / date_utils

time_now(timezone_name="UTC")

date_utils(
  action="convert_timezone",
  value="2026-04-21T12:00:00+00:00",
  target_timezone="America/New_York"
)

date_utils でサポートされているアクション: parse、convert_timezone、add、diff。オフセットなしの日付には timezone_name が使用されます。タイムゾーンは UTC、America/New_York、Europe/Madrid などのIANA名である必要があります。

memory_set / memory_get

memory_set(key="usuario_nombre", value="Carlos", namespace="default")
memory_get(key="usuario_nombre", namespace="default")
memory_list(prefix="usuario_", namespace="default")
memory_search(query="Carlos", namespace="default")

データは ~/.local/share/mcp-toolkit/memory.db に保存されます。 すべてのメモリツールは、プロジェクト、クライアント、または会話ごとにデータを分離するための namespace を受け入れます。指定がない場合は default が使用されます。

run_python

Parámetros:
  code     (str) — código Python a ejecutar
  timeout  (int) — segundos máximos, default 10, máximo 60
  stdin    (str) — entrada estándar opcional

セキュリティ制限:

  • 最小限の環境: ホストプロセスのシークレットや任意の変数を継承しません

  • 実行ごとの一時作業ディレクトリ

  • 環境変数によってHTTPプロキシを無効化

  • メモリ制限: 256 MB (Linux/macOS)

  • 厳格なタイムアウト: 時間切れになるとプロセスは強制終了されます

  • Windowsでは、Pythonから適用されるプロセスごとのメモリ制限はありません

  • ネットワークブロックは強力な分離を保証するものではありません。信頼できないコードを実行する場合は、ネットワークポリシーを備えたコンテナやVM内でサーバーを実行することを推奨します

run_js

run_python と同じパラメータ。システムにNode.jsがインストールされている必要があります。

開発

git clone https://github.com/YoshiLoL0526/mcp-toolkit
cd mcp-toolkit
uv sync
uv run python -m playwright install chromium

# Ejecutar en modo desarrollo
uv run mcp-toolkit

# Tests
uv run pytest

新しいツールの追加

  1. async def mi_tool(...) -> str 関数を含む mcp_toolkit/tools/mi_tool.py を作成する

  2. server.py でインポートし、mcp.tool()(mi_tool) で登録する

  3. 再インストール: uv tool install --python 3.13 . --reinstall

プロジェクト構造

mcp-toolkit/
├── pyproject.toml
├── README.md
├── mcp_toolkit/
│   ├── server.py              # FastMCP app + registro
│   ├── tools/
│   │   ├── web_search.py      # Playwright: buscar + extraer
│   │   ├── fetch_url.py       # Extraer una URL directa
│   │   ├── http_request.py    # Cliente HTTP genérico
│   │   ├── date_time.py       # Fechas, zonas horarias y duraciones
│   │   ├── memory.py          # SQLite KV store con namespaces
│   │   ├── run_python.py      # Sandbox Python
│   │   └── run_js.py          # Sandbox Node.js
│   └── utils/
│       ├── browser.py         # Singleton Playwright
│       └── sandbox.py         # Helpers de subprocess y timeout
└── tests/

ライセンス

MIT

Install Server
A
license - permissive license
A
quality
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Kody

    Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.

  • Motecloud Memory

    Cloud-hosted MCP server for durable AI memory

  • gread

    An MCP server that gives your AI access to the source code and docs of all public github repos

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/YoshiLoL0526/mcp-toolkit'

If you have feedback or need assistance with the MCP directory API, please join our Discord server