Nash

🚀 Nash MCP サーバー

Nash MCP（モデルコンテキストプロトコル (MCP) サーバー）は、コマンド実行、Python コードの実行、Web コンテンツの取得、タスク管理をシームレスに統合します。

🚀 クイックスタート

Nash MCP は、コマンド実行、Python コードの実行、Web コンテンツの取得、タスク管理をシームレスに統合するサーバーです。以下に、インストール方法と使用方法を説明します。

✨ 主な機能

• コマンド実行：シェルコマンドを実行し、エラーを処理します。
• Python 実行：Python コードを実行し、エラーをキャプチャします。
• セキュリティ資格情報：API キーを保存およびアクセスし、大規模言語モデル (LLM) に機密データが漏れるのを防ぎます。
• Web コンテンツ取得：Web ページのコンテンツを取得して解析し、分析に利用します。
• タスク管理：再利用可能なタスクを保存および整理します。

📦 インストール

インストール要件

• Python 3.11 以上
• Poetry パッケージマネージャー（推奨）

インストール手順

git clone https://github.com/nash-run/nash-mcp.git
cd nash-mcp
poetry install

📚 ドキュメント

環境変数の設定

以下の環境変数は、実行時に指定する必要があります。

使用方法

ツールモジュール

コマンド実行

execute_command(command: str) -> str

パラメータ：command - 実行するシェルコマンド
戻り値：コマンドの出力またはエラーメッセージ

Python 実行

execute_python(code: str, file_name: str = "") -> str

パラメータ：

• code: 実行する Python コードの断片
• file_name (オプション): コードファイルの名前。デフォルトは空文字列

よくある注意事項

1. 資格情報管理：すべての API キーは環境変数を介して読み込む必要があり、ハードコードは避けてください。
2. ログ記録：すべての操作とツールの実行ログは指定されたディレクトリに記録され、後で問題を調査するのに便利です。
3. セキュリティ監査：定期的にサーバーコードと設定ファイルをレビューし、不正アクセスのリスクがないことを確認することをお勧めします。

開発ガイド

ログシステム

詳細なタイムスタンプ付きの操作ログは、NASH_LOGS_PATH で指定されたディレクトリに保存され、すべての操作とツールの実行状況が記録されます。

テストフレームワーク

poetry run pytest

コードカバレッジテスト付き：

poetry run pytest --cov=nash_mcp

📄 ライセンス

MIT License