久久精品国内一区二区三区,91成人区人妻精品一区二区在线,国产一区二区福利盒子

項目說明

這是一個同時支持stdio，streamableHttpless和sse三種協議的MCP-Server的框架（ts語言）。

為什么我想做這個框架呢？因為隨著AI發展，現在越來越多業務需要和AI相結合。而我在做AI應用中發現，MCP服務在AI方向的業務使用頻率很高，但隨著業務的加深，發現存在以下痛點：

1.針對不同業務，對于mcp-server需要的類型不同，有的就需要stdio，有的需要網絡請求

2.不同平臺對MCP服務協議要求不同，有支持streamableHttp，有僅支持sse的。

這兩種情況，會出現相同功能重復開發，重復造輪子，浪費時間成本

3. 此外，有些研發人員目前并不了解MCP，在業務開發時候需要現學

而這會讓研發周期加長，時間成本耗費過多

所以為了解決以上痛點，我從0-1搭建了這個框架。這個框架特點：

1.同時支持stdio，streamableHttpless和sse三種模式，實現一次開發支持三種模式

2.所有功能都拆分為獨立模塊。這樣即使不懂的人，只要在指定的文件里面編寫業務邏輯，就可以創造自己的mcp服務

3.支持環境變量，可通過環境變量配置域名，服務地址，端口和host，真正適用于生產使用

4.切換模式也很簡單，只要在啟動腳本根據需要，切換啟動命令即可，改動成本近乎無

5.添加日志模塊，方便查閱啟動和服務調用情況

6.同時添加行云腳本，支持行云部署

github地址：https://github.com/XingtongCai/mcp-server-ts?

coding地址： http://xingyun.jd.com/codingRoot/jdcloud-fe/mcp-server/tree/main/demo

內容介紹

整個框架的結構很簡單，就如下這些：

## 目錄結構
- build: 編譯之后的文件
- src
 -- router: 配置streamableHttp和sse協議的路由
   -- index.ts: 注冊streamableHttp路由入口
   -- mcp.ts: streamableHttp的配置路徑，具體為`process.env.MCP_BASE_PATH`的路徑請求,如果沒有配置，默認/mcp。如果有需要添加二級路徑，例如 /mcp/event，需要在這里面添加一下/event,如果一級不用動
   -- sse.ts: sse的配置路徑，具體為`process.env.MCP_BASE_PATH`的路徑請求,如果沒有配置，默認/mcp。如果有需要添加二級路徑，例如 /mcp/event，需要在這里面添加一下/event,如果一級不用動
 -- tools: mcp的工具 
   -- index.ts: 注冊工具
   -- mockFunc.ts: 模擬一個工具寫法 - 這部分需要根據業務開發
 -- cli.ts: 命令行解析工具
 -- index.ts: 總入口
 -- server.ts: 創建Mcp服務
 -- sse.ts: 運行sse模式
 -- stdio.ts: 運行stdio模式
 -- streamableHttp.ts: 運行streamableHttp模式
- xingyun/bin : 是根據我們業務使用的部署工具開發的部署腳本 - 這部分需要根據實際部署平臺更改，我這個支持行云部署
- build_xingyun.sh: 是根據我們業務使用的部署工具開發的部署腳本 - 這部分需要根據實際部署平臺更改，我這個支持行云部署

啟動服務方式

a.本地啟動

1.啟動stdio: npm run start 是默認啟動stdio

2.啟動StreamableHttp: npm run start:http 是默認啟動端口3001

3.更改端口啟動StreamableHttp: npm run dev:http 或者 npm run start -- -t http -p 3001

-t httt: 代表啟動StreamableHttp

-p 3001: 代表啟動端口3001

4.啟動sse: npm run start:sse 是默認啟動端口3001

b.部署啟動

我在 xingyun/bin/control.sh中寫的啟動腳本，這段代碼是啟動streamableHttpless的，如果需要啟動sse，需要改為 `npm run start:sse`

start(){
    npm run start:http
    sleep 3
    status
}

生產環境配置

# 監聽特定內網IP（例如：192.168.1.100）
export MCP_HOST=192.168.1.100
export MCP_PORT=3001

# 使用內網域名（可選）
export MCP_DOMAIN=mcp-server.internal.com

# 修改基礎路徑（可選，默認是 /mcp）
export MCP_BASE_PATH=/api/mcp

### 端口配置優先級
1. 環境變量 `MCP_PORT`（最高優先級）
2. 命令行參數 `--port` 
3. 默認值：3001端口

### 訪問地址優先級
1. 環境變量 `MCP_DOMAIN`（最高優先級）
2. 環境變量 `MCP_HOST`
3. 默認: localhost

### 內網訪問方式
假設你的內網服務器IP是 `192.168.1.100`，端口是 `3001`：

**基礎訪問：**
```
http://192.168.1.100:3001/sales
```

**帶域名的訪問：**
```
http://mcp-server.internal.com/sales
```

**自定義路徑：**
```
http://192.168.1.100:3001/api/mcp

項目關鍵代碼說明

這個是package.json文件，也是我們一開始要看的，`cli.js`這個文件是我們啟動文件，也是解析命令行的工具，真實區分的地方在index.ts文件中

"scripts": {
    "build": "tsc && chmod 755 build/src/index.js  build/src/cli.js",
    "start": "node ./build/src/cli.js",
    "start:http": "node ./build/src/cli.js --transport http",
    "start:sse": "node ./build/src/cli.js --transport sse",
    "dev:http": "node ./build/src/cli.js  --transport http --port 3002",
    "stop": "pkill -f "demo" || true",
    "restart": "npm run stop && npm run start:http",
    "inspector": "npx @modelcontextprotocol/inspector"
  },

index.ts 的關鍵代碼，在這區分不同模式，然后進入到各自的處理模塊。各自模塊就是調用sdk，配置域名等操作，代碼過長，不展示了，但是這幾個文件不用動。