Yunxin

v1.0.0Communicationstable

yunxin-mcp-server

yunxinmcpai-integration
Share:
9
Stars
0
Downloads
0
Weekly
0/5

What is Yunxin?

Yunxin is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to yunxin-mcp-server

yunxin-mcp-server

This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • yunxin-mcp-server

Use Cases

Access Yunxin communication service
netease-im

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedApr 27, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx yunxin

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Yunxin

The Yunxin MCP Server connects AI assistants to NetEase Yunxin's cloud communication platform, providing 17 tools for instant messaging and real-time communication analytics. The tools cover sending peer-to-peer and team messages, querying IM message history, retrieving application-level IM daily statistics, monitoring online connection counts, checking API and SDK usage stats, and inspecting RTC room membership and quality metrics including stuck rates and quality distribution. It requires an AppKey and AppSecret from your Yunxin account and runs via uvx with no separate install step.

Prerequisites

  • Python 3.8+ with uv and uvx installed
  • A NetEase Yunxin account with an application created
  • AppKey and AppSecret from your Yunxin application console
  • Claude Desktop, Cursor, or another MCP-compatible AI client
  • Network access to the Yunxin API endpoints
1

Install uv and verify uvx is available

The server is run via uvx, which is included with the uv package manager. Install uv if it is not already available.

pip install uv
uvx --version
2

Obtain your Yunxin AppKey and AppSecret

Log into the Yunxin developer console, create or select your application, and copy the AppKey and AppSecret from the application settings page.

3

Test the server manually

Run the server directly from the command line to verify credentials are accepted before adding it to your AI client.

AppKey=your_appkey AppSecret=your_secret uvx yunxin_mcp_server
4

Add the server to your MCP client configuration

Edit your claude_desktop_config.json to add the Yunxin server entry with credentials passed as environment variables.

{
  "mcpServers": {
    "yunxin_mcp": {
      "name": "yunxin-mcp-server",
      "type": "stdio",
      "command": "uvx",
      "args": ["yunxin_mcp_server"],
      "env": {
        "AppKey": "your_yunxin_appkey",
        "AppSecret": "your_yunxin_appsecret"
      }
    }
  }
}
5

Restart your client and verify the tools load

Restart Claude Desktop or your MCP client. Ask it to query recent IM statistics or check RTC room status to confirm the Yunxin tools are active.

Yunxin Examples

Client configuration

Claude Desktop configuration for the Yunxin MCP server using uvx with AppKey and AppSecret credentials.

{
  "mcpServers": {
    "yunxin_mcp": {
      "name": "yunxin-mcp-server",
      "type": "stdio",
      "command": "uvx",
      "args": ["yunxin_mcp_server"],
      "env": {
        "AppKey": "your_yunxin_appkey",
        "AppSecret": "your_yunxin_appsecret"
      }
    }
  }
}

Prompts to try

Use natural language to send messages, query IM history, and monitor RTC room quality.

- "Send a peer-to-peer message to user ID 12345 saying 'Meeting starts in 10 minutes'"
- "Query the IM message history for team 67890 from the last 24 hours"
- "Show me the daily IM statistics for our application for the past 7 days"
- "How many users are currently online and connected to the IM service?"
- "Check the RTC room quality distribution and show stuck rates for the top 20 rooms"

Troubleshooting Yunxin

Authentication failure or invalid credentials error

Verify that AppKey and AppSecret are copied exactly from the Yunxin developer console with no extra spaces. These are case-sensitive. Also confirm the application is in an active state in the console — suspended applications will reject API calls.

uvx command not found after installing uv

Run 'pip install uv' or follow the uv installation guide at https://github.com/astral-sh/uv. After installation, ensure the uv bin directory is in your PATH. On macOS and Linux this is typically ~/.local/bin.

RTC tools return empty data

RTC monitoring tools require active RTC room sessions in your application. If no rooms are active, query results will be empty. Confirm your application has the RTC product enabled in the Yunxin console, as it is a separate subscription from IM.

Frequently Asked Questions about Yunxin

What is Yunxin?

Yunxin is a Model Context Protocol (MCP) server that yunxin-mcp-server It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Yunxin?

Follow the installation instructions on the Yunxin GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Yunxin?

Yunxin works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Yunxin free to use?

Yes, Yunxin is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Communication MCP Servers

Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "yunxin": { "command": "npx", "args": ["-y", "yunxin"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Yunxin?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides