mcp-mianshiya

This MCP server exposes a simple interview question search capability that integrates with MCP clients via the MCP protocol. The core tool exposed here is questionSearch, which indexes or retrieves interview questions and returns links to the corresponding entries inside the 面试鸭 platform. To use it, connect your MCP-enabled agent or assistant (for example Claude, Cursor, or a custom MCP client) to this MCP server, then call the questionSearch tool with a query such as a keyword or topic. The server will respond with a list of questions and their links, enabling rapid access to relevant interview materials. The setup typically involves configuring the MCP client to point at this server and enabling the tool functionality within your model settings, so that the agent can invoke questionSearch as part of its reasoning workflow.

Prerequisites:

• Java 17 runtime
• Maven for building the server project
• Git to clone the repository

Step-by-step:

1. Clone the repository git clone https://github.com/yuyuanweb/mcp-mianshiya-server

2. Build the project cd mcp-mianshiya-server mvn clean package

3. Run the server (adjust the path to the generated jar as needed) java -Dspring.ai.mcp.server.stdio=true -Dspring.main.web-application-type=none -Dlogging.pattern.console= -jar target/mcp-server-0.0.1-SNAPSHOT.jar

4. Connect an MCP client

   • In your MCP client configuration, add a server entry pointing to the above host/port, using the provided mcp protocol. The server exposes the mianshiyaServer configuration as shown in the mcp_config field.
   • Enable the MCP server in your client UI, and select the questionSearch tool when building a prompt or tool suite for your agent.

Tips and notes:

• Ensure Java 17 is installed and available in your PATH.
• The example configuration uses a local jar path; replace /path/to/mcp-server-0.0.1-SNAPSHOT.jar with your actual build output path.
• If you customize Maven packaging, the jar name may differ; adjust accordingly.
• The MCP client configuration file (mcp-servers-config.json) should reference the same server name (mianshiyaServer) and the same command/arguments used to run the server.
• In client tooling like Cherry Studio, ensure stdio routing is enabled (stdio=true) so the MCP server can communicate via standard IO.
• If you plan to run multiple MCP servers, extend the mcpServers map with additional server-name entries following the same pattern.