Dealx

🚀 @模型上下文协议/SDK の MCP サーバー実装

このプロジェクトは、@模型上下文协议/SDK の 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

👥 貢献者

• [你的名字] - 初期実装
• [其他贡献者的姓名]

📄 ライセンス

[插入许可证内容]