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 框架具備管理多個遊戲角色的能力，支持 TypeScript 開發，可通過配置文件靈活設置服務器參數，還能使用環境變量和 CLI 參數進行高級配置。

📦 安裝指南

克隆倉庫

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
      }
    }
  }
}

啟動開發服務器

pnpm run dev

💻 使用示例

基礎用法

以下是啟動 MCP 服務器的基本步驟：

# 克隆倉庫
git clone git@github.com:yourusername/mcp.git
cd mcp
# 安裝依賴
pnpm install
# 啟動服務器
pnpm run start

高級用法

環境變量配置

您可以通過 env 字段在 mcp.json 中設置環境變量，或者直接傳遞 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 命令生成生產環境下的構建文件。

pnpm run build

部署到雲服務

將打包後的文件上傳至您的雲服務提供商（如 AWS、Azure 或阿里雲），並配置相應的啟動腳本。

使用 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

📚 詳細文檔

示例項目

創建新項目

使用以下命令創建一個新的 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
      }
    }
  }
}

擴展和插件

開發插件

創建自定義插件並將其發佈到 npm registry，供其他開發者使用。

使用插件

在 mcp.json 中引用插件：

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

教程和示例

官方文檔

查閱 MCP 官方文檔 獲取更多詳細信息。

示例倉庫

參考 MCP 的 示例項目 學習實際應用。

社區和支持

討論組

加入 MCP 的官方討論群，與其他開發者交流經驗：

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

提交問題

在 GitHub 倉庫中提交 issue 報告 bug 或提出改進建議。

版本歷史

v1.0.0 - 初始版本

• 添加基本功能和文檔

v2.0.0 - 主要更新

• 引入 TypeScript 支持
• 增強配置選項
• 優化性能和穩定性

🔧 技術細節

MCP 框架基於 TypeScript 開發，使用 Node.js 作為運行環境，通過配置文件 mcp.json 來管理服務器參數。服務器啟動時會讀取配置文件中的命令、參數和環境變量，以確保服務器按照預期運行。在開發模式下，支持熱重載和調試功能，方便開發者快速迭代代碼。

📄 許可證

本項目遵循 MIT 協議。更多細節請參閱 LICENSE 文件。