Dealx

🚀 @模型上下文協議/SDK 的 MCP 服務器實現

本項目提供了 @模型上下文協議/SDK 的 MCP 服務器實現方案，可幫助用戶輕鬆搭建相關服務器，實現工具列表獲取、工具調用等功能。

🚀 快速開始

你可以通過以下步驟快速啟動 MCP 服務器。

📦 安裝指南

使用 npm 安裝

npm install @模型上下文協議/mcp-server

作為命令使用

npx @模型上下文協議/mcp-server

在代碼中使用

import { McpServer } from "@模型上下文協議/mcp-server";
const server = new McpServer();
server.start(1234);

🔧 配置說明

編輯配置文件

編輯 config.json 文件：

{
  "apiEndpoint": "http://localhost:3000",
  "allowedOrigins": ["*"]
}

啟動服務器

npm start

💻 使用示例

工具列表

獲取所有可用工具的列表：

server.setRequestHandler(ListToolsRequestSchema, () => ({
  tools: [
    {
      name: SEARCH_ADS,
      description: "搜索廣告",
      inputSchema: SearchAdsInputSchema
    }
  ]
}));

調用工具

調用具體的工具：

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  const { name, arguments: args } = request.params;
  switch (name) {
    case SEARCH_ADS:
      return await searchAds(args);
    default:
      throw new McpError(ErrorCode.MethodNotFound, `未知工具：${name}`);
  }
});

📚 詳細文檔

工具詳情 - 搜索廣告

搜索平臺上的廣告：

interface SearchAdsParams {
  keyword?: string;
  filters: {
    priceRange?: [number, number];
    category?: string;
  };
}

export async function searchAds(params: SearchAdsParams) {
  try {
    const result = await fetch(`${config.apiEndpoint}/search`, {
      method: "POST",
      headers: {
        "Content-Type": "application/json"
      },
      body: JSON.stringify(params)
    });

    if (!result.ok) throw new Error("搜索廣告失敗");

    const data = await result.json();
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(data, null, 2),
        }
      ],
    };
  } catch (error) {
    throw new McpError(ErrorCode.InternalError, error instanceof Error ? error.message : String(error));
  }
}

環境變量配置

在項目根目錄創建 .env 文件：

DEALX_API_URL=http://localhost:3000
PORT=1234

然後加載環境變量：

import { config } from "dotenv";
config();

計劃中的未來工具

• create_ad: 創建新廣告
• edit_ad: 編輯現有廣告
• delete_ad: 刪除廣告
• get_threads: 獲取廣告的討論線程
• create_thread: 創建新的討論線程

項目結構

src/
├── config.ts
├── server.ts
└── tools/
    └── searchAds.ts

🤝 貢獻者

• [你的名字] - 初始實現
• [其他貢獻者的姓名]

📄 許可證

[插入許可證內容]