Claude Ts Mcps

🚀 ソフトウェア開発者向けClaude TypeScript MCPサーバー

このプロジェクトは、大規模言語モデル（LLM）を用いた開発支援を行うソフトウェア開発者に対応するためのModel Context Protocol（MCP）サーバーの集合です。多くの開発者はClineの直接的なVSCode統合機能を好むかもしれませんが、APIの費用が高いことが問題となる場合があります。本プロジェクトでは、強力な機能を備えた一連のMCPサーバーを実装することでこの問題を解決します。

🚀 クイックスタート

Claude TypeScript MCPサーバーを使用することで、Claude Desktopの機能を強化し、日常の開発タスクを効率的に行うことができます。以下の手順でサーバーをセットアップしてください。

✨ 主な機能

機能

• Brave Search：Brave Search APIを通じて、高速かつプライバシーに配慮したウェブ検索を実現します。
• ファイルシステム：読み取り、書き込み、ディレクトリ管理など、安全なファイル操作機能を提供します。
• Git：コミット、プル、ブランチ切り替えなど、完全なGitバージョン管理操作をサポートします。
• GitHub：GitHub APIを統合し、リポジトリ管理、問題追跡、Pull Request操作をサポートします。
• Shellコマンド：制御された環境でシステムコマンドを実行できます。
• Puppeteer：ウェブページのスクレイピングやインタラクションテストなど、ブラウザ自動化を実現します。
• Fetch：URLからコンテンツを取得し、HTMLをMarkdownに変換する機能を提供します。

セキュリティ

すべてのサーバーには厳格なセキュリティ対策が組み込まれています。

• ファイルシステムとShellサーバーはアクセス権限を制限します。
• Shellコマンドの実行はホワイトリスト方式で行われ、特定の安全なコマンドのみが許可されます。
• Fetchサーバーはデフォルトでrobots.txtルールを遵守し、不要なウェブスクレイピングの競合を避けます。

📦 インストール

使用前の準備

システム要件

• オペレーティングシステム：Node.jsをサポートする任意の最新のオペレーティングシステム（Windows、macOS、Linux）
• Node.jsバージョン：16.0以上
• npmバージョン：6.0以上

インストール手順

1. このリポジトリをクローンします：

   git clone https://github.com/your-repository.git
   

2. 依存関係をインストールします：

   cd your-repository
   npm install
   

3. サーバーを起動します：

   npm start
   

📚 ドキュメント

設定の説明

設定ファイルの読み込み

1. Claude Desktopを開きます。
2. （プロジェクトのルートディレクトリにある）config.jsonファイルをインポートします。
3. Claude Desktopが必要な環境変数にアクセスできることを確認します。

環境変数の設定

GitHubサーバー

GitHub MCPサーバーは複数アカウントの設定をサポートしています。

"env": {
    "GITHUB_PERSONAL_TOKEN": "your-personal-token",
    "GITHUB_WORK_ACCOUNT_TOKEN": "your-work-account-token"
}

リクエストでaccount_profileパラメータを指定することで、特定のアカウントを選択できます。

{
    "owner": "username",
    "repo": "repo-name",
    "path": "path/to/file.txt",
    "account_profile": "work" // 勤務用アカウントトークンを使用
}

Fetchサーバー

環境変数を使用してFetchの動作をカスタマイズできます。

"env": {
    "CUSTOM_USER_AGENT": "YourCustomAgent/1.0", // カスタムUser-Agent文字列
    "IGNORE_ROBOTS_TXT": "true" // `robots.txt`ルールを無視する（注意して使用）
}

使用方法

1. Claude Desktopを起動します。
2. プロジェクトのルートディレクトリにあるconfig.jsonファイルを読み込みます。
3. 新しいツール機能を使用し始めます。

開発ガイド

各MCPサーバーはsrcディレクトリにある独立したTypeScriptモジュールです。

• src/brave-search.ts：Brave Search APIの統合
• src/filesystem.ts：ファイルシステム操作
• src/git.ts：Gitコマンドの実行
• src/github.ts：GitHub APIの統合（リポジトリ、問題、Pull Requestを含む）
• src/shell.ts：制御されたShellコマンドの実行
• src/puppeteer.ts：ブラウザ自動化機能
• src/fetch.ts：URLからのコンテンツ取得とHTMLからMarkdownへの変換

新機能の追加

1. srcディレクトリに新しいTypeScriptファイルを作成します。
2. @modelcontextprotocol/sdkを使用して新しいMCPサーバーを実装します。
3. 新しいサーバーを設定ファイルに追加します。

セキュリティ上の注意事項

• ファイルシステムとShellサーバーはアクセス権限を厳格に制限し、不正アクセスを防止します。
• 常にユーザー入力を検証し、コマンドインジェクション攻撃を避けます。
• 設定時には許可するディレクトリパスを慎重に選択してください。
• GitHubトークンは信頼できるソースから取得し、安全に保管してください。

参考資料

• モデルコンテキストプロトコル（Model Context Protocol）
• MCPサーバークイックスタートガイド
• Anthropic Claude

📄 ライセンス

[プロジェクトのライセンス情報]