MCP Source Server

🚀 MCPソースサーバー

このMCPサーバーは、Claude DesktopなどのAIアシスタントを開発ワークフローに活用するためのツールです。セットアップ後、AIアシスタントがプロジェクト内の関連ファイルを自動検索し、コードベースを分析し、スマートな修正提案を提供します。これにより、AIサービスに加入しているユーザーの繰り返しのコピー&ペースト作業を大幅に削減し、開発プロセスを効率化します。

🚀 クイックスタート

インストール

# リポジトリをクローン
git clone git@hgithub.com/Chakotay-Lee/mcp-source-server
cd mcp-source-server

# 依存関係をインストール
npm install

# プロジェクトをビルド
npm run build

# テストを実行
npm test

Claude Desktopの設定

Claude Desktopの設定ファイルに以下の設定を追加してください。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "source-code-server": {
      "command": "node",
      "args": ["/path/to/your/mcp-source-server/dist/index.js"],
      "env": {
        "MCP_WORKSPACE_DIR": "/path/to/your/workspace"
      }
    }
  }
}

/path/to/your/mcp-source-server を実際のプロジェクトのパスに、/path/to/your/workspace を希望のワークスペースディレクトリに置き換えてください。

✨ 主な機能

コアファイル操作

• ファイル読み取り: サイズ制限付きでソースコードファイルを安全に読み取ります。
• ファイル書き込み: オプションでバックアップを作成しながら、ファイルを作成および更新します。
• ファイル一覧表示: メタデータ付きでディレクトリの内容を閲覧します。
• ストリーム書き込み: 大きなファイルの書き込みを効率的に処理します。

🆕 拡張操作 (v0.2.1)

• ファイル削除: 自動バックアップ付きで安全にファイルを削除します。
• ファイルの名前変更/移動: ファイルの名前を変更するか、ディレクトリ間で移動します。
• 部分書き込み: LLM最適化機能で、ファイル全体を書き換えることなく特定のセクションを更新します。

🔒 セキュリティ機能

• ディレクトリトラバーサル保護: ワークスペース外へのアクセスを防止します。
• ファイル拡張子ホワイトリスト: 承認されたファイルタイプのみを許可します。
• パスブラックリスト: 敏感なディレクトリへのアクセスをブロックします。
• サイズ制限: 過度のファイル操作を防止します。
• 同時操作制限: システムリソースを保護します。

📦 利用可能なツール

基本操作

• read_source_file - ファイル内容を読み取ります。
• write_source_file - ファイルに内容を書き込みます。
• list_source_files - ディレクトリ内のファイルを一覧表示します。
• stream_write_source_file - 大きなファイルのストリーム書き込みを行います。

🆕 拡張操作

• delete_source_file - バックアップオプション付きでファイルを削除します。
• rename_source_file - バックアップ付きでファイルの名前を変更するか移動します。
• partial_write_source_file - 特定のファイル内容を更新します（LLM最適化）。

ユーティリティ

• get_server_stats - サーバーの状態と統計情報を取得します。

🔧 設定

環境変数

• MCP_WORKSPACE_DIR: ワークスペースディレクトリを設定します（デフォルト: ./workspace）。

セキュリティ設定

サーバーには組み込みのセキュリティ設定が含まれています。

許可されるファイル拡張子

• プログラミング: .js, .ts, .jsx, .tsx, .py, .cpp, .c, .h など
• Web: .html, .css, .scss, .json, .xml, .yaml など
• ドキュメント: .md, .txt, .rst, .adoc
• テンプレート: .template, .example, .sample, .config
• 拡張子なし: Dockerfile, Makefile, .gitignore など

ブラックリストされたパス

• .. - ディレクトリトラバーサル防止
• .git/ - Gitリポジトリファイル
• node_modules/ - 依存関係ディレクトリ
• .env. - 環境ファイル（テンプレートを除く）
• secrets/ - シークレットディレクトリ
• システムファイル (.DS_Store, Thumbs.db)

💻 使用例

基本的なファイル操作

// ファイルを読み取ります
await callTool('read_source_file', { filePath: 'src/index.js' });

// ファイルを書き込みます
await callTool('write_source_file', {
  filePath: 'src/new-file.js',
  content: 'console.log("Hello World");',
  createBackup: true
});

// ファイルを一覧表示します
await callTool('list_source_files', { dirPath: 'src' });

🆕 拡張操作

// ファイルを削除します（バックアップ付き）
await callTool('delete_source_file', {
  filePath: 'old-file.js',
  createBackup: true
});

// ファイルの名前を変更/移動します
await callTool('rename_source_file', {
  oldPath: 'old-name.js',
  newPath: 'src/new-name.js',
  createBackup: true
});

// LLM最適化された部分更新
await callTool('partial_write_source_file', {
  filePath: 'utils.js',
  oldContent: 'function oldFunction() { return "old"; }',
  newContent: 'function newFunction() { return "updated"; }'
});

🛡️ セキュリティに関する注意事項

許可される開発ファイル

✅ .gitignore, .env.template, Dockerfile, Makefile, package.json, tsconfig.json

保護されるファイル

🔒 .env, .env.local, .env.production, .git/config, node_modules/, secrets/

🧪 テスト

# すべてのテストを実行します
npm test

# 特定のテストを実行します
npm test -- --testNamePattern="should allow development configuration files"

# カバレッジ付きで実行します
npm run test:coverage

🔄 バックアップシステム

サーバーは .backups ディレクトリにタイムスタンプ付きで自動的にバックアップを作成します。

• 形式: filename.timestamp.backup
• 場所: workspace/.backups/
• 自動クリーンアップを推奨します。

📊 パフォーマンス機能

• 同時操作制限: システムの過負荷を防止します。
• ファイルサイズ制限: ファイルごとのデフォルト制限は10MBです。
• LLM最適化: 部分書き込みにより、小さな変更のファイルI/Oを削減します。
• ストリーム処理: 大きなファイルを効率的に処理します。

🤝 貢献方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. 新機能に対するテストを追加します。
5. すべてのテストが通過することを確認します。
6. プルリクエストを送信します。

📄 ライセンス

[あなたのライセンスをここに記載]

🆕 変更履歴

v0.2.1

• ✨ ファイル削除機能を追加しました。
• ✨ ファイルの名前変更/移動機能を追加しました。
• ✨ LLM最適化された部分書き込み機能を追加しました。
• 🔧 .env.template ファイルのアクセスを修正しました。
• 🔧 正確なパターンマッチングによりセキュリティを強化しました。
• 🧪 包括的なテストスイート（21個のテスト）を追加しました。

v0.1.0

• 🎉 基本的なファイル操作を備えた初回リリースです。
• 🔒 セキュリティ機能とパス検証を追加しました。
• 📚 MCPプロトコルの実装を追加しました。