MCP Ts Morph Refactoring Tools

🚀 MCP サーバー構成ドキュメント

MCP（Multiple Character Programming）は、複数のゲームキャラクターを管理するためのフレームワークです。このガイドでは、TypeScript ベースの MCP サーバーの構成と実行方法を説明します。

🚀 クイックスタート

📦 依存関係のインストール

Node.js (バージョン 14 以上) と npm がインストールされていることを確認してください。 以下のコマンドを実行して、プロジェクトの依存関係をインストールします。

pnpm install

⚙️ mcp.json の構成

mcp.json ファイルを作成し、必要なサーバー構成を追加します。例えば：

{
  "mcpServers": {
    "mcp-ts-morph": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "NODE_ENV": "production",
        "PORT": 3000
      }
    }
  }
}

🚀 サーバーの起動

以下のコマンドを実行して、MCP サーバーを起動します。

pnpm run start

✨ 高度な構成

🌐 環境変数

mcp.json の env フィールドを使用して環境変数を設定するか、CLI 引数を直接渡すことができます。

例：

# デフォルト値を使用
pnpm run start --name mcp-ts-morph

# カスタムポートと環境
pnpm run start --name mcp-ts-morph --port 3001 --env production

👤 異なるユーザーとして実行

特定のユーザーとして MCP サーバーを実行するには、sudo コマンドを使用します。

sudo -u username pnpm run start --name mcp-ts-morph

📦 パッケージ化とデプロイ

📦 パッケージ化

pnpm run build コマンドを使用して、本番環境用のビルドファイルを生成します。

☁️ クラウドサービスへのデプロイ

パッケージ化されたファイルをクラウドサービスプロバイダー（AWS、Azure、または阿里云など）にアップロードし、適切な起動スクリプトを構成します。

🐞 エラー排除

🚫 サーバーが起動しない場合

1. ログファイルを確認して、具体的なエラー情報を特定します。
2. すべての依存関係が正しくインストールされていることを確認します。
3. ファイアウォール設定を確認し、ターゲットポートがブロックされていないことを確認します。

🌐 ネットワーク接続の問題

1. サーバーとクライアントが同じネットワークにあることを確認します。
2. ターゲットポートが開いており、使用可能であることを確認します。

💻 コード貢献

📝 コミット規則

Conventional Commits 規則に従って、コミットメッセージの形式を統一します。

例：

git commit -m "feat: 新しい MCP サーバー構成ドキュメントを追加"

🎉 Pull Request の作成

GitHub で各機能または修正に対して独立した Pull Request を作成し、説明に変更内容を詳細に記載します。

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。詳細については、LICENSE ファイルを参照してください。

🚀 MCP の完全ガイド

🔽 リポジトリのクローン

git clone git@github.com:yourusername/mcp.git
cd mcp

📦 依存関係のインストール

以下のコマンドを実行して、プロジェクトに必要なすべてのパッケージをインストールします。

pnpm install

⚙️ MCP サーバーの初期化

mcp.json 構成ファイルを作成し、実行する予定のサーバー構成を追加します。例えば：

{
  "mcpServers": {
    "mcp-ts-morph": {
      "command": "node",
      "args": ["src/index.ts"],
      "env": {
        "NODE_ENV": "development",
        "PORT": 3000,
        "DEBUG": true
      }
    }
  }
}

🚀 開発サーバーの起動

以下のコマンドを実行して、MCP サーバーを起動します。

pnpm run dev

💡 高度な機能

🔥 ホットリロードとデバッグ

開発モードでは、コードを変更するとサーバーが自動的に再読み込みされます。

pnpm run dev

📦 パッケージ化と本番デプロイ

最適化された本番用ビルドファイルを生成します。

pnpm run build

本番環境で MCP サーバーを起動します。

pnpm run start

🚀 サンプルプロジェクト

🆕 新しいプロジェクトの作成

以下のコマンドを使用して、新しい MCP プロジェクトを作成します。

pnpm create mcp my-project
cd my-project

⚙️ 構成例

mcp.json の構成例：

{
  "mcpServers": {
    "web-server": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "NODE_ENV": "production",
        "PORT": 8080
      }
    },
    "api-gateway": {
      "command": "node",
      "args": ["dist/api.js"],
      "env": {
        "NODE_ENV": "production",
        "PORT": 3001
      }
    }
  }
}

🐳 Docker を使用したデプロイ

🐋 Dockerfile の作成

# ベースイメージ
FROM node:16

# 作業ディレクトリの設定
WORKDIR /app

# 依存関係のインストール
COPY package.json pnpm-lock.yaml ./
RUN pnpm install --frozen-lockfile

# ソースコードのコピー
COPY . .

# 起動コマンド
CMD ["pnpm", "run", "start"]

🛠️ イメージのビルド

docker build -t mcp-server .

🚀 コンテナの実行

docker run -p 3000:3000 mcp-server

🧩 拡張機能とプラグイン

💻 プラグインの開発

カスタムプラグインを作成し、npm registry に公開して、他の開発者が使用できるようにします。

📦 プラグインの使用

mcp.json でプラグインを参照します。

{
  "plugins": [
    "@example/plugin-name"
  ]
}

📚 チュートリアルとサンプル

📖 公式ドキュメント

MCP 公式ドキュメント を参照して、詳細情報を取得してください。

🚀 サンプルリポジトリ

MCP の サンプルプロジェクト を参考にして、実際のアプリケーションを学習してください。

👥 コミュニティとサポート

💬 ディスカッショングループ

MCP の公式ディスカッショングループに参加して、他の開発者と経験を共有しましょう。

• Discord: https://discord.mcp.dev
• Telegram: https://t.me/mcpchat

🐛 問題の報告

GitHub リポジトリで issue を提出して、バグを報告したり、改善提案を行ったりしてください。

📜 バージョン履歴

v1.0.0 - 初期バージョン

• 基本機能とドキュメントの追加

v2.0.0 - 主要な更新

• TypeScript サポートの導入
• 構成オプションの強化
• パフォーマンスと安定性の最適化

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。詳細については、LICENSE ファイルを参照してください。