Frequently Asked Questions (FAQ) about AivisSpeech MCP Server

Q: What is the AivisSpeech MCP Server? A: The AivisSpeech MCP Server is an implementation of the Model Context Protocol (MCP) designed to connect AI assistants and other applications with the AivisSpeech Engine for high-quality voice synthesis.

Q: What are the key features of the AivisSpeech MCP Server? A: Key features include MCP protocol compliance, high-quality voice synthesis via AivisSpeech Engine integration, TypeScript-based design for type safety, and easy configuration and extensibility.

Q: What are the system requirements for running the AivisSpeech MCP Server? A: The server requires Node.js 18.x or higher, npm 9.x or higher, and a pre-installed AivisSpeech Engine.

Q: How do I install the AivisSpeech MCP Server? A: Installation involves cloning the repository, installing dependencies using npm install, building the project using npm run build, and configuring environment variables in the .env file.

Q: How do I configure the AivisSpeech API URL? A: The AivisSpeech API URL is configured in the .env file using the AIVIS_SPEECH_API_URL variable. Ensure this points to the correct endpoint of your AivisSpeech Engine.

Q: What is the purpose of the .cursor/mcp.json file? A: The .cursor/mcp.json file configures the Cursor MCP settings, specifying the command and arguments to start the AivisSpeech MCP Server.

Q: How do I run the server in development mode? A: Use the command npm run dev to start the server in development mode with hot-reloading.

Q: How do I build the server for production? A: Use the command npm run build to build the server for production.

Q: How do I start the server in production mode? A: After building, use the command npm start to start the server in production mode.

Q: How can I run tests for the AivisSpeech MCP Server? A: Use the command npm test to execute the test suite.

Q: What is the architecture of the AivisSpeech MCP Server? A: The server consists of two main components: the MCP Service, which handles client requests, and the AivisSpeech Service, which communicates with the AivisSpeech Engine for voice synthesis.

Q: Where can I find the API specifications for the server? A: Detailed API specifications can be found in the AivisSpeech Engine API specification.

Q: What is the Model Context Protocol (MCP)? A: MCP is an open protocol that standardizes how applications provide context to Large Language Models (LLMs), enabling seamless integration between AI models and external data sources.

Q: What should I do if I cannot connect to the AivisSpeech Engine? A: Verify that the AIVIS_SPEECH_API_URL in the .env file is correctly set and that the AivisSpeech Engine is running and accessible.

Q: What should I do if I cannot hear any audio being played? A: Check your system’s audio settings and ensure that the appropriate audio device is selected.

Q: How can I contribute to the AivisSpeech MCP Server project? A: You can contribute by submitting bug reports, feature requests, or pull requests through the GitHub issue tracker.

Q: What license is the AivisSpeech MCP Server released under? A: The AivisSpeech MCP Server is released under the MIT License.

Q: What is UBOS and how does it relate to AivisSpeech MCP Server? A: UBOS is a full-stack AI Agent Development Platform that helps businesses orchestrate AI Agents, connect them with enterprise data, and build custom AI Agents. Integrating AivisSpeech MCP Server with UBOS enhances the voice capabilities of AI Agents.