UNPKG

@302ai/custom-mcp

Version:

A Model Context Protocol server

154 lines (118 loc) β€’ 5.28 kB
# <p align="center">πŸ€– 302AI Custom MCP ServerπŸš€βœ¨</p> <p align="center">A customizable MCP service that supports tool selection and flexible configuration to meet your various needs.</p> <p align="center"><a href="https://www.npmjs.com/package/@302ai/custom-mcp" target="blank"><img src="https://file.302.ai/gpt/imgs/github/20250102/72a57c4263944b73bf521830878ae39a.png" /></a></p > <p align="center"><a href="README_zh.md">δΈ­ζ–‡</a> | <a href="README.md">English</a> | <a href="README_ja.md">ζ—₯本θͺž</a></p> ![](docs/302_AI_Custom_MCP_Server_en.png) ## Tutorial Open MCP Server in the menu ![](docs/302_AI_Custom_MCP_Server_screenshot_01.png) Enter a name and select the tools you want to configure. ![](docs/302_AI_Custom_MCP_Server_screenshot_02.png) This is the current list of available tools, which is continuously being updated ![](docs/302_AI_Custom_MCP_Server_screenshot_03.png) After creation, click on the Server name to view the Server configuration ![](docs/302_AI_Custom_MCP_Server_screenshot_04.png) Different Servers use different KEYs to obtain tool configurations. The client only needs to be installed once, no repeated installation required. Switching between different Servers only requires changing the API_KEY. ![](docs/302_AI_Custom_MCP_Server_screenshot_05.png) Open the MCP Server button in the chatbot ![](docs/302_AI_Custom_MCP_Server_screenshot_06.png) Enter the key you just created in 302ai-custom-server ![](docs/302_AI_Custom_MCP_Server_screenshot_07.png) ![](docs/302_AI_Custom_MCP_Server_screenshot_08.png) Turn on the Server switch to start using it. Taking Chatwise as an example for use in third-party clients Click on the Server name, then click the copy button ![](docs/302_AI_Custom_MCP_Server_screenshot_09.png) ![](docs/302_AI_Custom_MCP_Server_screenshot_10.png) Open Chatwise settings-tools, click the bottom left corner, import JSON from clipboard ![](docs/302_AI_Custom_MCP_Server_screenshot_11.png) ![](docs/302_AI_Custom_MCP_Server_screenshot_12.png) MCP Server imported successfully, you can now use it normally. ## ✨ Features ✨ - πŸ”§ Quickly generate your own MCP Server by selecting different APIs - 🌐 Compatible with: Various MCP-supported clients, including 302.AI's chatbot - πŸ’» Currently includes multiple tool types such as BrowserUseTools, FileTools, ImageTools, MathTools, SandboxTools, with more updates coming ## Development Install dependencies: ```bash npm install ``` Build the server: ```bash npm run build ``` For development with auto-rebuild: ```bash npm run watch ``` ## Installation To use with Claude Desktop, add the server config: On MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json` On Windows: `%APPDATA%/Claude/claude_desktop_config.json` ```json { "mcpServers": { "302ai-custom-mcp": { "command": "npx", "args": ["-y", "@302ai/custom-mcp"], "env": { "302AI_API_KEY": "YOUR_API_KEY_HERE", "LANGUAGE": "YOUR_LANGUAGE_HERE" } } } } ``` To use with Cherry Studio, add the server config: ```json { "mcpServers": { "Li2ZXXJkvhAALyKOFeO4N": { "name": "302ai-custom-mcp", "description": "", "isActive": true, "registryUrl": "", "command": "npx", "args": [ "-y", "@302ai/custom-mcp" ], "env": { "302AI_API_KEY": "YOUR_API_KEY_HERE" } } } } ``` To use with ChatWise, copy the following content to clipboard ```json { "mcpServers": { "302ai-custom-mcp": { "command": "npx", "args": ["-y", "@302ai/custom-mcp"], "env": { "302AI_API_KEY": "YOUR_API_KEY_HERE" } } } } ``` Go to Settings -> Tools -> Add button -> Select Import from Clipboard ![](docs/302_AI_Custom_MCP_Server_screenshot_13.jpg) ### Find Your 302AI_API_KEY [here](https://dash.302.ai/apis/mcp-server) [Using Tutorials](https://help.302.ai/docs/MCP-Server-de-shi-yong) ### Debugging Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector), which is available as a package script: ```bash npm run inspector ``` The Inspector will provide a URL to access debugging tools in your browser. ## ✨ About 302.AI ✨ [302.AI](https://302.ai/en/) is an enterprise-oriented AI application platform that offers pay-as-you-go services, ready-to-use solutions, and an open-source ecosystem.✨ 1. 🧠 Integrates the latest and most comprehensive AI capabilities and brands, including but not limited to language models, image models, voice models, and video models. 2. πŸš€ Develops deep applications based on foundation models - we develop real AI products, not just simple chatbots 3. πŸ’° Zero monthly fee, all features are pay-per-use, fully open, achieving truly low barriers with high potential. 4. πŸ›  Powerful management backend for teams and SMEs - one person manages, many people use. 5. πŸ”— All AI capabilities provide API access, all tools are open source and customizable (in progress). 6. πŸ’‘ Strong development team, launching 2-3 new applications weekly, products updated daily. Developers interested in joining are welcome to contact us.