## Tencent SDK Model Context Protocol (MCP) Server for Cursor IDE

This repository provides a CLI-based Model Context Protocol (MCP) server that exposes Tencent SDK documentation and Tencent API resources to LLM-powered tools.
This improves the LLM AI Agent's ability to understand and interact with Tencent's SDKs and APIs.


## Features

- MCP server exposing tools for interacting with Tencent via JSON-RPC over STDIN/STDOUT.
- MCP server supports SSE Mode by supplying `HTTP_PORT` environment variable.
- Retrieve official Tencent SDK documentation (HTML → Markdown) for:
  - Languages: JavaScript, Java, Swift, Objective-C, Kotlin.
  - API reference sections: configuration, calls function.
- Retrieve official Tencent TUICallKit SDK documentation (HTML → Markdown) for:
  - TUICallKit SDK languages: JavaScript, Kotlin, Swift.
  - TUICallKit SDK topics: configuration, calls function.
- Converts remote HTML articles to Markdown using `jsdom` and `turndown` for consistent documentation formatting.
- Input validation via Zod schemas for all tool parameters, ensuring robust error handling.
- Extensible tool definitions leveraging the Model Context Protocol SDK (`@modelcontextprotocol/sdk`) with `McpServer` and `StdioServerTransport`.


## Prerequisites
- Node.js (>= 18) and npm
- Cursor IDE with MCP support


## How To Use
To set up the @tencentcloud/sdk-mcp MCP Server, follow these steps:

- Step1: Installation.

```
npx -y @tencentcloud/sdk-mcp
```


- Step2: In your Cursor project, create or open the `.cursor/mcp.json` or `~/.cursor/mcp.json` files and add your config.

```javascript
{
  "mcpServers": {
    "tencentcloud-sdk-mcp": {
      "command": "npx",
      "args": ["-y", "@tencentcloud/sdk-mcp"],
      "env": {
        "SDKAPPID": "YOUR_SDKAPPID",
        "SECRETKEY": "YOUR_SECRET_KEY"
      }
    }
  }
}
```
When you save the file, a notification is displayed. In the prompt, click **Enable**.

![mcp-server-prompt](./mcp-server-prompt.png)

- Step3: Navigate to **Cursor Settings** (the gear icon in top right corner) -> **MCP**, and check if tencentcloud-sdk-mcp server is enabled.

![cursor-setting](cursor-setting.png)


Step4: Ask the AI agent to build your Tencentcloud sdk app for you by describing the functionality yourself or by using a sample prompt.

> [!WARNING]
Make sure to use the Agent mode. Depending on your Cursor rules, you may also need to explicitly ask the AI agent to use the Tencentcloud sdk-mcp server.