MCP Server Developer Tool

🚀 モジュール化 MCP サーバ

これは、github.com/metoro-io/mcp-golang ライブラリを使用して実装された Model Context Protocol (MCP) サーバの Go 実装で、モジュール化方式で再構築されています。

📁 プロジェクト構造

mcp-server/
├── cmd/
│   └── mcp-server/
│       └── main.go           # エントリーポイント
├── internal/
│   ├── config/
│   │   └── config.go         # サーバー設定
│   ├── server/
│   │   ├── server.go         # MCP サーバー実装
│   │   └── server_test.go    # サーバーテスト
│   ├── tools/
│   │   ├── tool.go           # ツールインターフェース
│   │   ├── execute.go        # shell コマンド実行ツール
│   │   ├── showfile.go       # ファイル表示ツール
│   │   ├── searchfile.go     # ファイル内検索ツール
│   │   └── writefile.go      # ファイル書き込みツール
│   └── utils/
│       └── response.go       # レスポンス共通ツール
├── go.mod
├── go.sum
└── README.md

🛠️ ビルドと実行

# サーバーをビルドする
cd cmd/mcp-server
go build -o mcp-server

# サーバーを実行する
./mcp-server

🔒 セキュリティ機能

このサーバーには、ファイル操作を指定されたディレクトリに制限するためのパス制限機能が含まれています。

許可されたパスの設定

許可されたパスは、以下のいくつかの方法で設定できます。

1. コマンドラインフラグを使用する

# 特定のディレクトリでの操作のみを許可する
./mcp-server --paths=/home/user/safe:/tmp/workspace

# 許可されたパス内であっても、特定のパスを明示的に拒否する
./mcp-server --paths=/home/user --deny-paths=/home/user/.ssh:/home/user/credentials

2. 環境変数を使用する

# 許可されたパスを設定する
export MCP_ALLOWED_PATHS=/home/user/safe:/tmp/workspace

# 拒否されたパスを設定する
export MCP_DENIED_PATHS=/home/user/.ssh:/home/user/credentials

# サーバーを実行する
./mcp-server

3. プログラム的に設定する

カスタム設定を作成することもできます。

cfg := config.DefaultConfig()
cfg.AddAllowedPath("/path/to/allow")
cfg.AddDeniedPath("/path/to/deny")

server, err := server.NewServerWithConfig(cfg)

デフォルトの動作

• パスが指定されていない場合、デフォルトでサーバーは現在の作業ディレクトリのみを許可します。
• 一般的な敏感なディレクトリ（.git や .env など）は自動的に拒否リストに追加されます。

Shell コマンドのセキュリティ

execute_shell_command ツールについて：

• コマンドは、一般的なユーティリティのホワイトリストに制限されます。
• カスタム実行可能パスは、許可されたパス設定のチェックを通過する必要があります。
• 作業ディレクトリは許可されたパス内にある必要があります。

➕ 新しいツールの追加

新しいツールを追加するには、以下の手順に従ってください。

1. internal/tools/ ディレクトリに新しい Go ファイルを作成します。
2. Tool インターフェース（tool.go で定義されています）を実装します。
3. ツールをサーバーに登録します。通常は server.go で行います。

例えば、新しいツールを追加するには：

// new_tool.go
package tools

import (
	"internal/tools"
)

type NewTool struct{}

func (n *NewTool) Execute(args []string) error {
    // 具体的な実行ロジックを実装する
    return nil
}

func init() {
	tools.Register("new_tool", &NewTool{})
}

🧪 テスト

サーバーをテストするには、以下のコマンドを実行します。

# テストを実行する
go test -v ./...