Dealx

🚀 MCP Server Implementation for @Model Context Protocol/SDK

This project provides an MCP server implementation for the @Model Context Protocol/SDK, enabling users to manage and utilize various tools.

📦 Installation

You can install the package using npm:

npm install @模型上下文协议/mcp-server

Then use it as a command:

npx @模型上下文协议/mcp-server

Or use it in your code:

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

⚙️ Configuration

Edit the config.json file:

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

Then start the server:

npm start

💻 Usage Examples

Basic Usage

Tool List

Get a list of all available tools:

server.setRequestHandler(ListToolsRequestSchema, () => ({
  tools: [
    {
      name: SEARCH_ADS,
      description: "Search for ads",
      inputSchema: SearchAdsInputSchema
    }
  ]
}));

Call a Tool

Call a specific tool:

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, `Unknown tool: ${name}`);
  }
});

Advanced Usage

Search Ads

Search for ads on the platform:

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("Failed to search for ads");

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

🌐 Environment Variables

Create a .env file in the project root directory:

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

Then load the environment variables:

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

🚧 Planned Future Tools

• create_ad: Create a new ad
• edit_ad: Edit an existing ad
• delete_ad: Delete an ad
• get_threads: Get the discussion threads of an ad
• create_thread: Create a new discussion thread

📁 Project Structure

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

👥 Contributors

• [Your Name] - Initial implementation
• [Other Contributors' Names]

📄 License

[Insert license content]