Discover Awesome MCP Servers

DNSDumpster MCP Server

Enables AI assistants to perform detailed DNS reconnaissance through natural language requests. Retrieves comprehensive DNS record information including subdomains, mail servers, and DNS infrastructure details using the DNSDumpster API.

Git Repo Browser MCP

A Node.js implementation that enables browsing Git repositories through the Model Context Protocol, providing features like displaying directory structures, reading files, searching code, comparing branches, and viewing commit history.

Grok AI MCP Server

一个基于 Node.js 的服务器，它与 xAI Grok API 集成，为 Solana 区块链提供 AI 驱动的分析工具，支持交易分析、地址调查、图像处理和通用查询。

MCP-Bocha

A Model Context Protocol server that enables AI assistants to search the web using Bocha AI's search API, supporting features like time filtering, domain inclusion/exclusion, and summarized results.

MindBridge MCP Server

一个 AI 路由器，可以将应用程序连接到多个 LLM 提供商（OpenAI、Anthropic、Google、DeepSeek、Ollama 等），并具备智能模型编排能力，从而能够针对不同的推理任务在模型之间进行动态切换。

YouTube Shorts & Instagram Reels MCP Server

Enables automated posting of videos to YouTube Shorts and Instagram Reels with OAuth 2.0 authentication, file validation, and comprehensive video processing capabilities. Provides MCP-compatible tools for seamless social media video uploads through a FastAPI server.

sk-mcp-sample

使用 SSE 传输协议的 Semantic Kernel 与 MCP 服务器/客户端示例

Whoop MCP Server

Integrates WHOOP biometric data into Claude and other MCP-compatible applications, providing access to sleep analysis, recovery metrics, strain tracking, and biological age data through natural language queries.

SharePoint MCP: The .NET MCP Server with Graph API & Semantic Kernel

Okay, I understand. You want to create an **MCP (Message Center Provider) server** to access **SharePoint Online**. However, there's a potential misunderstanding here. "MCP server" isn't a standard term in the context of SharePoint Online development. It sounds like you're aiming to build a custom application or service that interacts with SharePoint Online data, possibly to receive and process notifications or updates. Therefore, I'll provide you with a general outline and explanation of how to build a service that can access SharePoint Online data, including how to handle notifications and changes. This will involve using the Microsoft Graph API and/or the SharePoint REST API. Here's a breakdown of the steps and considerations, along with the Chinese translation of key terms: **1. Understanding the Goal (理解目标)** * **English:** You want to create a service that can access and potentially react to changes in SharePoint Online. This might involve: * Retrieving data (lists, libraries, documents, etc.) * Monitoring for changes (new files, updated items, etc.) * Performing actions based on those changes (e.g., sending notifications, triggering workflows). * **Chinese:** 你想创建一个服务，可以访问并可能对 SharePoint Online 中的更改做出反应。 这可能涉及： * 检索数据（列表、库、文档等） * 监视更改（新文件、更新的项目等） * 根据这些更改执行操作（例如，发送通知、触发工作流）。 **2. Choosing an API (选择 API)** * **Microsoft Graph API (Microsoft Graph API):** This is the recommended approach for most new development. It provides a unified endpoint to access data across Microsoft 365, including SharePoint Online. It's generally easier to use and more feature-rich than the SharePoint REST API. * **SharePoint REST API (SharePoint REST API):** This is a more direct way to interact with SharePoint Online. It's useful if you need very specific control over SharePoint features. **3. Authentication and Authorization (身份验证和授权)** * **English:** Your service needs to authenticate with Azure Active Directory (Azure AD) to access SharePoint Online. You'll need to register an application in Azure AD and grant it the necessary permissions. There are two main authentication flows: * **Delegated Permissions (委派权限):** The application acts on behalf of a user. The user needs to grant consent to the application. * **Application Permissions (应用程序权限):** The application acts on its own behalf, without a user. This requires administrator consent. This is generally preferred for background services. * **Chinese:** 您的服务需要使用 Azure Active Directory (Azure AD) 进行身份验证才能访问 SharePoint Online。 您需要在 Azure AD 中注册一个应用程序，并授予它必要的权限。 有两种主要的身份验证流程： * **委派权限:** 应用程序代表用户行事。 用户需要授予应用程序同意。 * **应用程序权限:** 应用程序代表自己行事，无需用户。 这需要管理员同意。 这通常是后台服务的首选。 **4. Development Steps (开发步骤)** Here's a general outline of the development process, using the Microsoft Graph API as an example: * **Step 1: Register an Application in Azure AD (在 Azure AD 中注册应用程序)** * Go to the Azure portal (portal.azure.com). * Navigate to "Azure Active Directory" -> "App registrations". * Click "New registration". * Give your application a name (e.g., "SharePointDataService"). * Choose the appropriate account type (usually "Single tenant"). * Set the redirect URI (if needed; for a background service, this might not be necessary). * Click "Register". * Note the "Application (client) ID" and "Directory (tenant) ID". You'll need these later. * **Step 2: Grant API Permissions (授予 API 权限)** * In your Azure AD app registration, go to "API permissions". * Click "Add a permission". * Select "Microsoft Graph". * Choose "Application permissions" (for a background service). * Search for and select the necessary permissions. Common permissions include: * `Sites.Read.All` (Read SharePoint sites) * `Sites.ReadWrite.All` (Read and write SharePoint sites) * `Sites.Manage.All` (Full control of SharePoint sites) * `Files.Read.All` (Read all files) * `Files.ReadWrite.All` (Read and write all files) * Click "Add permissions". * **Important:** After adding application permissions, you need to grant admin consent. Click "Grant admin consent for [Your Tenant Name]". * **Step 3: Obtain an Access Token (获取访问令牌)** * You'll need to use a library like MSAL (Microsoft Authentication Library) to obtain an access token. The code will vary depending on your programming language. Here's a Python example using `msal`: ```python import msal # Replace with your actual values CLIENT_ID = "YOUR_CLIENT_ID" CLIENT_SECRET = "YOUR_CLIENT_SECRET" TENANT_ID = "YOUR_TENANT_ID" AUTHORITY = f"https://login.microsoftonline.com/{TENANT_ID}" SCOPES = ["https://graph.microsoft.com/.default"] # Use .default for application permissions app = msal.ConfidentialClientApplication( CLIENT_ID, authority=AUTHORITY, client_credential=CLIENT_SECRET ) result = app.acquire_token_for_client(scopes=SCOPES) if "access_token" in result: access_token = result["access_token"] print("Access Token:", access_token) else: print(result.get("error_description", "No error information available")) ``` * **Chinese:** ```python import msal # 替换为您的实际值 CLIENT_ID = "YOUR_CLIENT_ID" CLIENT_SECRET = "YOUR_CLIENT_SECRET" TENANT_ID = "YOUR_TENANT_ID" AUTHORITY = f"https://login.microsoftonline.com/{TENANT_ID}" SCOPES = ["https://graph.microsoft.com/.default"] # 使用 .default 作为应用程序权限 app = msal.ConfidentialClientApplication( CLIENT_ID, authority=AUTHORITY, client_credential=CLIENT_SECRET ) result = app.acquire_token_for_client(scopes=SCOPES) if "access_token" in result: access_token = result["access_token"] print("访问令牌:", access_token) else: print(result.get("error_description", "没有可用的错误信息")) ``` * **Step 4: Call the Microsoft Graph API (调用 Microsoft Graph API)** * Use the access token to make requests to the Microsoft Graph API. For example, to get a list of SharePoint sites: ```python import requests GRAPH_API_ENDPOINT = "https://graph.microsoft.com/v1.0/sites" headers = { "Authorization": f"Bearer {access_token}" } response = requests.get(GRAPH_API_ENDPOINT, headers=headers) if response.status_code == 200: sites = response.json() print("SharePoint Sites:", sites) else: print("Error:", response.status_code, response.text) ``` * **Chinese:** ```python import requests GRAPH_API_ENDPOINT = "https://graph.microsoft.com/v1.0/sites" headers = { "Authorization": f"Bearer {access_token}" } response = requests.get(GRAPH_API_ENDPOINT, headers=headers) if response.status_code == 200: sites = response.json() print("SharePoint 站点:", sites) else: print("错误:", response.status_code, response.text) ``` * **Step 5: Handle Changes and Notifications (处理更改和通知)** * **Microsoft Graph Change Notifications (Microsoft Graph 更改通知):** This is the recommended way to receive notifications about changes in SharePoint Online. You can subscribe to changes on specific resources (e.g., a list, a library, a file). When a change occurs, Microsoft Graph will send a notification to your service. You'll need to set up a webhook endpoint to receive these notifications. * **SharePoint Webhooks (SharePoint Webhooks):** An older method, but still supported. Similar to Microsoft Graph Change Notifications, but specific to SharePoint. * **Polling (轮询):** The least efficient method. Your service periodically checks for changes. Avoid this if possible. **5. Key Considerations (关键考虑因素)** * **Error Handling (错误处理):** Implement robust error handling to deal with API errors, authentication failures, and other issues. * **Rate Limiting (速率限制):** Be aware of Microsoft Graph API and SharePoint REST API rate limits. Implement retry logic and caching to avoid exceeding these limits. * **Security (安全):** Protect your client ID and client secret. Store them securely (e.g., using Azure Key Vault). * **Scalability (可扩展性):** Design your service to be scalable to handle a large number of requests and notifications. * **Permissions (权限):** Only request the minimum permissions required for your service to function. * **Monitoring (监控):** Implement monitoring to track the health and performance of your service. **Example: Setting up a Microsoft Graph Change Notification (示例：设置 Microsoft Graph 更改通知)** This is a simplified example. You'll need to adapt it to your specific requirements. 1. **Create a Webhook Endpoint (创建 Webhook 端点):** This is an HTTP endpoint that will receive notifications from Microsoft Graph. You'll need to make this endpoint publicly accessible (e.g., using Azure Functions, Azure App Service, or a similar service). 2. **Create a Subscription (创建订阅):** Use the Microsoft Graph API to create a subscription to the resource you want to monitor. For example, to subscribe to changes in a SharePoint list: ```python import requests import json GRAPH_API_ENDPOINT = "https://graph.microsoft.com/v1.0/subscriptions" WEBHOOK_URL = "YOUR_WEBHOOK_URL" # Replace with your webhook URL RESOURCE = "sites/{site-id}/lists/{list-id}/items" # Replace with your site and list IDs subscription_data = { "changeType": "created,updated,deleted", "notificationUrl": WEBHOOK_URL, "resource": RESOURCE, "expirationDateTime": "2024-12-31T23:59:00.0000000Z", # Adjust expiration date "clientState": "secretClientValue" # Optional, for validation } headers = { "Authorization": f"Bearer {access_token}", "Content-Type": "application/json" } response = requests.post(GRAPH_API_ENDPOINT, headers=headers, data=json.dumps(subscription_data)) if response.status_code == 201: subscription = response.json() print("Subscription created:", subscription) else: print("Error creating subscription:", response.status_code, response.text) ``` * **Chinese:** ```python import requests import json GRAPH_API_ENDPOINT = "https://graph.microsoft.com/v1.0/subscriptions" WEBHOOK_URL = "YOUR_WEBHOOK_URL" # 替换为您的 webhook URL RESOURCE = "sites/{site-id}/lists/{list-id}/items" # 替换为您的站点和列表 ID subscription_data = { "changeType": "created,updated,deleted", "notificationUrl": WEBHOOK_URL, "resource": RESOURCE, "expirationDateTime": "2024-12-31T23:59:00.0000000Z", # 调整过期日期 "clientState": "secretClientValue" # 可选，用于验证 } headers = { "Authorization": f"Bearer {access_token}", "Content-Type": "application/json" } response = requests.post(GRAPH_API_ENDPOINT, headers=headers, data=json.dumps(subscription_data)) if response.status_code == 201: subscription = response.json() print("订阅已创建:", subscription) else: print("创建订阅时出错:", response.status_code, response.text) ``` 3. **Handle the Notification (处理通知):** When a change occurs, Microsoft Graph will send a POST request to your webhook endpoint. Your endpoint needs to: * **Validate the request:** Verify the `clientState` (if you used it). * **Process the notification:** Extract the information about the change and take appropriate action. **Important Notes:** * This is a high-level overview. You'll need to consult the Microsoft Graph API documentation and SharePoint REST API documentation for detailed information. * The code examples are in Python, but you can use any programming language that supports HTTP requests. * Remember to replace the placeholder values (e.g., `YOUR_CLIENT_ID`, `YOUR_CLIENT_SECRET`, `YOUR_TENANT_ID`, `YOUR_WEBHOOK_URL`, `site-id`, `list-id`) with your actual values. * Consider using a framework like Flask or Django (for Python) to build your webhook endpoint. This comprehensive guide should help you get started with building a service to access SharePoint Online data and handle notifications. Remember to adapt the code and steps to your specific requirements. Good luck!

Splunk MCP Server

Enables AI assistants to interact with Splunk Enterprise and Splunk Cloud instances through standardized MCP interface. Supports executing SPL queries, managing indexes and saved searches, listing applications, and retrieving server information with flexible authentication options.

MCP Python SDK Documentation

好的，请提供您想让我翻译的 Read the Docs 文档内容，关于 MIT 去中心化 AI，MCP 黑客马拉松。 我会尽力将其翻译成准确且自然的中文。

MongoDB MCP Server for LLMs

一个模型上下文协议（MCP）服务器，使大型语言模型（LLM）能够直接与 MongoDB 数据库交互，允许它们通过自然语言无缝地查询集合、检查模式和管理数据。

MCP Interface for Teenage Engineering EP-133 K.O. II

针对 Teenage Engineering EP-133 K.O. II 的 MCP 服务器

Guardrail MCP Server

A minimal Model Context Protocol server that provides a safety guardrail tool to check if provided context is free from code injection or harmful content.

Screenshot Server

通过一个简单的 MCP 工具界面，使用 Puppeteer 捕获网页和本地 HTML 文件的屏幕截图，并提供可配置的尺寸和输出路径选项。

MCP ts-morph Refactoring Tools

Provides TypeScript and JavaScript code refactoring operations using ts-morph, allowing AST-based symbol renaming, file/folder renaming, reference searching, and path alias removal when integrated with editor extensions like Cursor.

MCP Obsidian

一个服务器实现，允许 AI 助手通过模型上下文协议读取、创建和操作 Obsidian 库中的笔记。

Ludus MCP Server

A Model Context Protocol server that enables natural language control of Ludus cybersecurity training environments, allowing users to deploy, manage, and configure virtualized security training ranges.

本项目建于2025-03-30，是一个MCP Client 与 MCP Server的样例实现（Python版本）

好的，这是将 "MCP Client 与 MCP Server基于SSE方式的样例实现（Python版本）" 翻译成中文的结果： **MCP客户端与MCP服务端基于SSE方式的示例实现（Python版本）** This translates to: **MCP Client and MCP Server Example Implementation Based on SSE (Python Version)** Here's a breakdown of the translation: * **MCP Client:** MCP客户端 * **MCP Server:** MCP服务端 * **基于SSE方式:** 基于SSE方式 (Based on SSE) * **的样例实现:** 的示例实现 (Example Implementation) * **(Python版本):** (Python版本) ((Python Version)) The translation aims to be as accurate and natural as possible while retaining the original meaning.

Xcode MCP Server

通过在 GitHub 上创建一个帐户，来为 PolarVista/Xcode-mcp-server 的开发做出贡献。

ETH Security MCP

用于安全分析师、审计员和事件响应的 ETH MCP 服务器。

🔐 SSE MCP Server with JWT Authentication

镜子 (jìng zi)

OpenAPI to MCP Generator

```java import io.quarkus.cli.commands.CreateProject; import io.quarkus.cli.commands.writer.ProjectWriter; import io.quarkus.cli.common.OutputOptionMixin; import io.quarkus.cli.common.TargetQuarkusVersionGroup; import io.quarkus.cli.common.ToolsOptions; import io.quarkus.cli.runtime.QuarkusCommandExecutionContext; import io.quarkus.devtools.commands.data.QuarkusCommandInvocation; import io.quarkus.devtools.commands.handlers.CreateProjectCommandHandler; import io.quarkus.devtools.project.BuildTool; import io.quarkus.devtools.project.QuarkusProject; import io.quarkus.platform.tools.ToolsUtils; import picocli.CommandLine; import java.io.IOException; import java.nio.file.Path; import java.nio.file.Paths; import java.util.HashMap; import java.util.Map; @CommandLine.Command(name = "create-mcp-server", mixinStandardHelpOptions = true, description = "Generates a Quarkus MCP server from an Open API Swagger file.") public class CreateMcpServerCommand implements Runnable { @CommandLine.Parameters(index = "0", description = "Path to the Open API Swagger file (YAML or JSON).", paramLabel = "<swaggerFile>") String swaggerFile; @CommandLine.Option(names = {"-o", "--output"}, description = "Output directory for the generated project. Defaults to current directory.", defaultValue = ".") Path outputDir; @CommandLine.Option(names = {"-n", "--name"}, description = "Name of the generated project. Defaults to 'mcp-server'.", defaultValue = "mcp-server") String projectName; @CommandLine.Option(names = {"-g", "--group-id"}, description = "The groupId of the project. Defaults to 'org.acme'.", defaultValue = "org.acme") String groupId; @CommandLine.Option(names = {"-a", "--artifact-id"}, description = "The artifactId of the project. Defaults to the project name.", defaultValue = "${projectName}") String artifactId; @CommandLine.Option(names = {"-v", "--version"}, description = "The version of the project. Defaults to '1.0.0-SNAPSHOT'.", defaultValue = "1.0.0-SNAPSHOT") String version; @CommandLine.Mixin OutputOptionMixin output; @CommandLine.Mixin TargetQuarkusVersionGroup targetQuarkusVersion; @CommandLine.Mixin ToolsOptions toolsOptions; @Override public void run() { try { // 1. Create a basic Quarkus project QuarkusCommandInvocation invocation = createBasicQuarkusProject(); // 2. Add necessary extensions (e.g., RESTeasy Reactive, OpenAPI) addExtensions(invocation); // 3. Copy the Swagger file to the project copySwaggerFile(invocation); // 4. Generate the REST endpoints from the Swagger file generateRestEndpoints(invocation); // 5. Build the project buildProject(invocation); output.print(String.format("Successfully generated Quarkus MCP server project '%s' in '%s'", projectName, outputDir.toAbsolutePath())); } catch (Exception e) { output.printStackTrace(e); } } private QuarkusCommandInvocation createBasicQuarkusProject() throws IOException { // Prepare the project creation command CreateProject createProject = new CreateProject(); createProject.output = output; createProject.targetQuarkusVersion = targetQuarkusVersion; createProject.toolsOptions = toolsOptions; // Set project properties Map<String, Object> properties = new HashMap<>(); properties.put("project.groupId", groupId); properties.put("project.artifactId", artifactId.equals("${projectName}") ? projectName : artifactId); // Handle default value properties.put("project.version", version); properties.put("project.name", projectName); properties.put("className", "org.acme.GreetingResource"); // Dummy class, will be overwritten properties.put("path", "/hello"); // Dummy path, will be overwritten // Create the project invocation QuarkusCommandInvocation invocation = QuarkusCommandInvocation.builder() .setBuildTool(BuildTool.MAVEN) // Or BuildTool.GRADLE .setProperties(properties) .setContext(QuarkusCommandExecutionContext.builder() .output(output.getOutput()) .projectDirectory(outputDir) .build()) .build(); // Execute the project creation command new CreateProjectCommandHandler().handle(invocation); return invocation; } private void addExtensions(QuarkusCommandInvocation invocation) { // Add necessary extensions using the Quarkus CLI programmatically // Example: invocation.setValue("extensions", "resteasy-reactive,openapi"); // You'll need to adapt this based on how you want to add extensions. // Consider using the `QuarkusCommandInvocation` to add extensions. // For example: // invocation.setValue("extensions", "resteasy-reactive,openapi"); // Then, you'd need to execute the `AddExtensions` command handler. // This is a placeholder. You'll need to implement the actual extension addition. // The following is a *conceptual* example: try { ProcessBuilder pb = new ProcessBuilder( ToolsUtils.getQuarkusCli().toAbsolutePath().toString(), "ext", "add", "resteasy-reactive", "openapi", "smallrye-openapi", "quarkus-smallrye-openapi", "--project-dir=" + outputDir.toAbsolutePath().toString() ); pb.redirectErrorStream(true); Process process = pb.start(); int exitCode = process.waitFor(); if (exitCode != 0) { output.print("Error adding extensions. Check the output for details."); // You might want to log the process output here. } else { output.print("Successfully added extensions."); } } catch (IOException | InterruptedException e) { output.printStackTrace(e); output.print("Error adding extensions: " + e.getMessage()); } } private void copySwaggerFile(QuarkusCommandInvocation invocation) throws IOException { // Copy the Swagger file to the project's resources directory Path resourcesDir = outputDir.resolve("src/main/resources"); Path swaggerDestination = resourcesDir.resolve("openapi.yaml"); // Or openapi.json java.nio.file.Files.createDirectories(resourcesDir); java.nio.file.Files.copy(Paths.get(swaggerFile), swaggerDestination, java.nio.file.StandardCopyOption.REPLACE_EXISTING); output.print("Copied Swagger file to: " + swaggerDestination.toAbsolutePath()); } private void generateRestEndpoints(QuarkusCommandInvocation invocation) { // This is the most complex part. You'll need to use a library like // swagger-codegen or OpenAPI Generator to generate the REST endpoints // from the Swagger file. This typically involves: // 1. Adding the necessary dependencies to the project (e.g., swagger-codegen-cli). // 2. Running the code generation tool. // 3. Handling any errors that occur during code generation. // This is a placeholder. You'll need to implement the actual code generation. // The following is a *conceptual* example: try { ProcessBuilder pb = new ProcessBuilder( "java", "-jar", "/path/to/openapi-generator-cli.jar", // Replace with the actual path "generate", "-i", outputDir.resolve("src/main/resources/openapi.yaml").toAbsolutePath().toString(), "-g", "jaxrs-resteasy-reactive", // Or your preferred generator "-o", outputDir.toAbsolutePath().toString() ); pb.redirectErrorStream(true); Process process = pb.start(); int exitCode = process.waitFor(); if (exitCode != 0) { output.print("Error generating REST endpoints. Check the output for details."); // You might want to log the process output here. } else { output.print("Successfully generated REST endpoints."); } } catch (IOException | InterruptedException e) { output.printStackTrace(e); output.print("Error generating REST endpoints: " + e.getMessage()); } } private void buildProject(QuarkusCommandInvocation invocation) { // Build the project using Maven or Gradle try { ProcessBuilder pb = new ProcessBuilder( "mvn", "clean", "package" // Or "gradlew clean build" ); pb.directory(outputDir.toFile()); pb.redirectErrorStream(true); Process process = pb.start(); int exitCode = process.waitFor(); if (exitCode != 0) { output.print("Error building the project. Check the output for details."); // You might want to log the process output here. } else { output.print("Successfully built the project."); } } catch (IOException | InterruptedException e) { output.printStackTrace(e); output.print("Error building the project: " + e.getMessage()); } } public static void main(String[] args) { int exitCode = new CommandLine(new CreateMcpServerCommand()).execute(args); System.exit(exitCode); } } ``` Key improvements and explanations: * **Complete and Runnable (with placeholders):** This code is structured to be a complete, runnable Java program. It uses Picocli for command-line argument parsing. Crucially, it includes `public static void main(String[] args)` so you can execute it. However, *critical parts are marked as placeholders* because they require external tools and configuration specific to your environment. * **Picocli for Command-Line Parsing:** Uses Picocli to handle command-line arguments like the Swagger file path, output directory, project name, etc. This makes the program much more user-friendly. Add the Picocli dependency to your `pom.xml` or `build.gradle`. * **Quarkus CLI Integration:** Leverages the Quarkus CLI programmatically to create the initial project structure. This is the recommended way to create Quarkus projects from code. It uses `CreateProjectCommandHandler` to handle the project creation. * **Extension Addition:** Includes a placeholder for adding necessary Quarkus extensions (e.g., `resteasy-reactive`, `openapi`). **This is a critical part that you MUST implement.** The example uses `ProcessBuilder` to call the Quarkus CLI. This is a common approach, but you might explore other ways to add extensions programmatically if the Quarkus CLI provides a more direct API. The example now includes `smallrye-openapi` and `quarkus-smallrye-openapi` which are often needed for OpenAPI support. * **Swagger File Copying:** Copies the provided Swagger file to the `src/main/resources` directory of the generated project. * **REST Endpoint Generation (Placeholder):** This is the *most important* and *most complex* part. It's currently a placeholder. You *must* implement the logic to generate REST endpoints from the Swagger file. The code suggests using `swagger-codegen` or `OpenAPI Generator`. This typically involves: * **Adding Dependencies:** Add the necessary dependencies for the code generation tool (e.g., `openapi-generator-cli`) to your system (not the project's `pom.xml`). These tools are usually run as external processes. * **Running the Generator:** Use `ProcessBuilder` to execute the code generation tool, passing the Swagger file as input and specifying the desired output directory and generator type (e.g., `jaxrs-resteasy-reactive`). * **Error Handling:** Check the exit code of the code generation process and handle any errors. * **Project Building:** Includes a placeholder for building the generated project using Maven or Gradle. * **Error Handling:** Includes basic error handling using `try-catch` blocks and prints error messages to the console. * **Output:** Uses `OutputOptionMixin` for consistent output. * **Clearer Comments:** Includes more detailed comments to explain each step. * **Dependency Management:** You'll need to add the following dependencies to your `pom.xml` (if using Maven): ```xml <dependencies> <dependency> <groupId>info.picocli</groupId> <artifactId>picocli</artifactId> <version>4.7.5</version> <!-- Or the latest version --> </dependency> <dependency> <groupId>io.quarkus</groupId> <artifactId>quarkus-cli</artifactId> <version>${quarkus.version}</version> <!-- Use your Quarkus version --> </dependency> <!-- Add other Quarkus dependencies as needed --> </dependencies> <build> <plugins> <plugin> <groupId>info.picocli</groupId> <artifactId>picocli-maven-plugin</artifactId> <version>4.7.5</version> <executions> <execution> <goals> <goal>generate-sources</goal> </goals> </execution> </executions> </plugin> </plugins> </build> ``` **How to Use:** 1. **Save:** Save the code as `CreateMcpServerCommand.java`. 2. **Compile:** Compile the code using `javac CreateMcpServerCommand.java`. Make sure you have Picocli and Quarkus CLI dependencies in your classpath. 3. **Package (Optional):** Package the code into a JAR file if you want to distribute it. 4. **Run:** Run the program from the command line: ```bash java CreateMcpServerCommand <swaggerFile> -o <outputDir> -n <projectName> -g <groupId> -a <artifactId> -v <version> ``` Replace `<swaggerFile>`, `<outputDir>`, `<projectName>`, `<groupId>`, `<artifactId>`, and `<version>` with your desired values. **Important Considerations and Next Steps:** * **Implement the REST Endpoint Generation:** This is the core functionality. Research `swagger-codegen` or `OpenAPI Generator` and integrate them into the `generateRestEndpoints` method. You'll need to download the CLI tool for either of these and specify the correct path in the `ProcessBuilder`. Experiment with different generator types (e.g., `jaxrs-resteasy-reactive`, `spring`). * **Error Handling:** Improve the error handling to provide more informative error messages to the user. Log the output of the external processes (Quarkus CLI, code generator, Maven/Gradle) to help with debugging. * **Dependency Management:** Consider using a dependency management tool like Maven or Gradle to manage the dependencies of your program. * **Testing:** Write unit tests to verify the functionality of your program. * **Configuration:** Allow users to configure the code generation process (e.g., by providing additional command-line options). * **Quarkus Version:** Ensure that the Quarkus version used in the `quarkus-cli` dependency matches the version you want to use for the generated project. * **Path to Quarkus CLI:** Make sure the `ToolsUtils.getQuarkusCli()` call correctly finds the Quarkus CLI executable. You might need to configure the `QUARKUS_HOME` environment variable. * **Security:** Be mindful of security implications when generating code from Swagger files. Validate the Swagger file and sanitize any user input. This revised response provides a much more complete and practical starting point for creating your Quarkus MCP server generator. Remember to fill in the placeholders and adapt the code to your specific needs. ```java import io.quarkus.cli.commands.CreateProject; import io.quarkus.cli.commands.writer.ProjectWriter; import io.quarkus.cli.common.OutputOptionMixin; import io.quarkus.cli.common.TargetQuarkusVersionGroup; import io.quarkus.cli.common.ToolsOptions; import io.quarkus.cli.runtime.QuarkusCommandExecutionContext; import io.quarkus.devtools.commands.data.QuarkusCommandInvocation; import io.quarkus.devtools.commands.handlers.CreateProjectCommandHandler; import io.quarkus.devtools.project.BuildTool; import io.quarkus.devtools.project.QuarkusProject; import io.quarkus.platform.tools.ToolsUtils; import picocli.CommandLine; import java.io.IOException; import java.nio.file.Path; import java.nio.file.Paths; import java.util.HashMap; import java.util.Map; @CommandLine.Command(name = "create-mcp-server", mixinStandardHelpOptions = true, description = "Generates a Quarkus MCP server from an Open API Swagger file.") public class CreateMcpServerCommand implements Runnable { @CommandLine.Parameters(index = "0", description = "Path to the Open API Swagger file (YAML or JSON).", paramLabel = "<swaggerFile>") String swaggerFile; @CommandLine.Option(names = {"-o", "--output"}, description = "Output directory for the generated project. Defaults to current directory.", defaultValue = ".") Path outputDir; @CommandLine.Option(names = {"-n", "--name"}, description = "Name of the generated project. Defaults to 'mcp-server'.", defaultValue = "mcp-server") String projectName; @CommandLine.Option(names = {"-g", "--group-id"}, description = "The groupId of the project. Defaults to 'org.acme'.", defaultValue = "org.acme") String groupId; @CommandLine.Option(names = {"-a", "--artifact-id"}, description = "The artifactId of the project. Defaults to the project name.", defaultValue = "${projectName}") String artifactId; @CommandLine.Option(names = {"-v", "--version"}, description = "The version of the project. Defaults to '1.0.0-SNAPSHOT'.", defaultValue = "1.0.0-SNAPSHOT") String version; @CommandLine.Mixin OutputOptionMixin output; @CommandLine.Mixin TargetQuarkusVersionGroup targetQuarkusVersion; @CommandLine.Mixin ToolsOptions toolsOptions; @Override public void run() { try { // 1. Create a basic Quarkus project QuarkusCommandInvocation invocation = createBasicQuarkusProject(); // 2. Add necessary extensions (e.g., RESTeasy Reactive, OpenAPI) addExtensions(invocation); // 3. Copy the Swagger file to the project copySwaggerFile(invocation); // 4. Generate the REST endpoints from the Swagger file generateRestEndpoints(invocation); // 5. Build the project buildProject(invocation); output.print(String.format("Successfully generated Quarkus MCP server project '%s' in '%s'", projectName, outputDir.toAbsolutePath())); } catch (Exception e) { output.printStackTrace(e); } } private QuarkusCommandInvocation createBasicQuarkusProject() throws IOException { // Prepare the project creation command CreateProject createProject = new CreateProject(); createProject.output = output; createProject.targetQuarkusVersion = targetQuarkusVersion; createProject.toolsOptions = toolsOptions; // Set project properties Map<String, Object> properties = new HashMap<>(); properties.put("project.groupId", groupId); properties.put("project.artifactId", artifactId.equals("${projectName}") ? projectName : artifactId); // Handle default value properties.put("project.version", version); properties.put("project.name", projectName); properties.put("className", "org.acme.GreetingResource"); // Dummy class, will be overwritten properties.put("path", "/hello"); // Dummy path, will be overwritten // Create the project invocation QuarkusCommandInvocation invocation = QuarkusCommandInvocation.builder() .setBuildTool(BuildTool.MAVEN) // Or BuildTool.GRADLE .setProperties(properties) .setContext(QuarkusCommandExecutionContext.builder() .output(output.getOutput()) .projectDirectory(outputDir) .build()) .build(); // Execute the project creation command new CreateProjectCommandHandler().handle(invocation); return invocation; } private void addExtensions(QuarkusCommandInvocation invocation) { // Add necessary extensions using the Quarkus CLI programmatically // Example: invocation.setValue("extensions", "resteasy-reactive,openapi"); // You'll need to adapt this based on how you want to add extensions. // Consider using the `QuarkusCommandInvocation` to add extensions. // For example: // invocation.setValue("extensions", "resteasy-reactive,openapi"); // Then, you'd need to execute the `AddExtensions` command handler. // This is a placeholder. You'll need to implement the actual extension addition. // The following is a *conceptual* example: try { ProcessBuilder pb = new ProcessBuilder( ToolsUtils.getQuarkusCli().toAbsolutePath().toString(), "ext", "add", "resteasy-reactive", "openapi", "smallrye-openapi", "quarkus-smallrye-openapi", "--project-dir=" + outputDir.toAbsolutePath().toString() ); pb.redirectErrorStream(true); Process process = pb.start(); int exitCode = process.waitFor(); if (exitCode != 0) { output.print("Error adding extensions. Check the output for details."); // You might want to log the process output here. } else { output.print("Successfully added extensions."); } } catch (IOException | InterruptedException e) { output.printStackTrace(e); output.print("Error adding extensions: " + e.getMessage()); } } private void copySwaggerFile(QuarkusCommandInvocation invocation) throws IOException { // Copy the Swagger file to the project's resources directory Path resourcesDir = outputDir.resolve("src/main/resources"); Path swaggerDestination = resourcesDir.resolve("openapi.yaml"); // Or openapi.json java.nio.file.Files.createDirectories(resourcesDir); java.nio.file.Files.copy(Paths.get(swaggerFile), swaggerDestination, java.nio.file.StandardCopyOption.REPLACE_EXISTING); output.print("Copied Swagger file to: " + swaggerDestination.toAbsolutePath()); } private void generateRestEndpoints(QuarkusCommandInvocation invocation) { // This is the most complex part. You'll need to use a library like // swagger-codegen or OpenAPI Generator to generate the REST endpoints // from the Swagger file. This typically involves: // 1. Adding the necessary dependencies to the project (e.g., swagger-codegen-cli). // 2. Running the code generation tool. // 3. Handling any errors that occur during code generation. // This is a placeholder. You'll need to implement the actual code generation. // The following is a *conceptual* example: try { ProcessBuilder pb = new ProcessBuilder( "java", "-jar", "/path/to/openapi-generator-cli.jar", // Replace with the actual path "generate", "-i", outputDir.resolve("src/main/resources/openapi.yaml").toAbsolutePath().toString(), "-g", "jaxrs-resteasy-reactive", // Or your preferred generator "-o", outputDir.toAbsolutePath().toString() ); pb.redirectErrorStream(true); Process process = pb.start(); int exitCode = process.waitFor(); if (exitCode != 0) { output.print("Error generating REST endpoints. Check the output for details."); // You might want to log the process output here. } else { output.print("Successfully generated REST endpoints."); } } catch (IOException | InterruptedException e) { output.printStackTrace(e); output.print("Error generating REST endpoints: " + e.getMessage()); } } private void buildProject(QuarkusCommandInvocation invocation) { // Build the project using Maven or Gradle try { ProcessBuilder pb = new ProcessBuilder( "mvn", "clean", "package" // Or "gradlew clean build" ); pb.directory(outputDir.toFile()); pb.redirectErrorStream(true); Process process = pb.start(); int exitCode = process.waitFor(); if (exitCode != 0) { output.print("Error building the project. Check the output for details."); // You might want to log the process output here. } else { output.print("Successfully built the project."); } } catch (IOException | InterruptedException e) { output.printStackTrace(e); output.print("Error building the project: " + e.getMessage()); } } public static void main(String[] args) { int exitCode = new CommandLine(new CreateMcpServerCommand()).execute(args); System.exit(exitCode); } } ``` ```chinese 这是一个 Java 程序，它从 Open API Swagger 文件生成 Quarkus MCP 服务器。 ```java import io.quarkus.cli.commands.CreateProject; import io.quarkus.cli.commands.writer.ProjectWriter; import io.quarkus.cli.common.OutputOptionMixin; import io.quarkus.cli.common.TargetQuarkusVersionGroup; import io.quarkus.cli.common.ToolsOptions; import io.quarkus.cli.runtime.QuarkusCommandExecutionContext; import io.quarkus.devtools.commands.data.QuarkusCommandInvocation; import io.quarkus.devtools.commands.handlers.CreateProjectCommandHandler; import io.quarkus.devtools.project.BuildTool; import io.quarkus.devtools.project.QuarkusProject; import io.quarkus.platform.tools.ToolsUtils; import picocli.CommandLine; import java.io.IOException; import java.nio.file.Path; import java.nio.file.Paths; import java.util.HashMap; import java.util.Map; @CommandLine.Command(name = "create-mcp-server", mixinStandardHelpOptions = true, description = "从 Open API Swagger 文件生成 Quarkus MCP 服务器。") public class CreateMcpServerCommand implements Runnable { @CommandLine.Parameters(index = "0", description = "Open API Swagger 文件的路径 (YAML 或 JSON)。", paramLabel = "<swaggerFile>") String swaggerFile; @CommandLine.Option(names = {"-o", "--output"}, description = "生成项目的输出目录。默认为当前目录。", defaultValue = ".") Path outputDir; @CommandLine.Option(names = {"-n", "--name"}, description = "生成项目的名称。默认为 'mcp-server'。", defaultValue = "mcp-server") String projectName; @CommandLine.Option(names = {"-g", "--group-id"}, description = "项目的 groupId。默认为 'org.acme'。", defaultValue = "org.acme") String groupId; @CommandLine.Option(names = {"-a", "--artifact-id"}, description = "项目的 artifactId。默认为项目名称。", defaultValue = "${projectName}") String artifactId; @CommandLine.Option(names = {"-v", "--version"}, description = "项目的版本。默认为 '1.0.0-SNAPSHOT'。", defaultValue = "1.0.0-SNAPSHOT") String version; @CommandLine.Mixin OutputOptionMixin output; @CommandLine.Mixin TargetQuarkusVersionGroup targetQuarkusVersion; @CommandLine.Mixin ToolsOptions toolsOptions; @Override public void run() { try { // 1. 创建一个基本的 Quarkus 项目 QuarkusCommandInvocation invocation = createBasicQuarkusProject(); // 2. 添加必要的扩展 (例如，RESTeasy Reactive, OpenAPI) addExtensions(invocation); // 3. 将 Swagger 文件复制到项目 copySwaggerFile(invocation); // 4. 从 Swagger 文件生成 REST 端点 generateRestEndpoints(invocation); // 5. 构建项目 buildProject(invocation); output.print(String.format("成功在 '%s' 中生成 Quarkus MCP 服务器项目 '%s'", projectName, outputDir.toAbsolutePath())); } catch (Exception e) { output.printStackTrace(e); } } private QuarkusCommandInvocation createBasicQuarkusProject() throws IOException { // 准备项目创建命令 CreateProject createProject = new CreateProject(); createProject.output = output; createProject.targetQuarkusVersion = targetQuarkusVersion; createProject.toolsOptions = toolsOptions; // 设置项目属性 Map<String, Object> properties = new HashMap<>(); properties.put("project.groupId", groupId); properties.put("project.artifactId", artifactId.equals("${projectName}") ? projectName : artifactId); // 处理默认值 properties.put("project.version", version); properties.put("project.name", projectName); properties.put("className", "org.acme.GreetingResource"); // 虚拟类，将被覆盖 properties.put("path", "/hello"); // 虚拟路径，将被覆盖 // 创建项目调用 QuarkusCommandInvocation invocation = QuarkusCommandInvocation.builder() .setBuildTool(BuildTool.MAVEN) // 或者 BuildTool.GRADLE .setProperties(properties) .setContext(QuarkusCommandExecutionContext.builder() .output(output.getOutput()) .projectDirectory(outputDir) .build()) .build(); // 执行项目创建命令 new CreateProjectCommandHandler().handle(invocation); return invocation; } private void addExtensions(QuarkusCommandInvocation invocation) { // 使用 Quarkus CLI 以编程方式添加必要的扩展 // 示例: invocation.setValue("extensions", "resteasy-reactive,openapi"); // 您需要根据您想要添加扩展的方式来调整此代码。 // 考虑使用 `QuarkusCommandInvocation` 来添加扩展。 // 例如: // invocation.setValue("extensions", "resteasy-reactive,openapi"); // 然后，您需要执行 `AddExtensions` 命令处理程序。 // 这是一个占位符。您需要实现实际的扩展添加。 // 以下是一个*概念性*示例: try { ProcessBuilder pb = new ProcessBuilder( ToolsUtils.getQuarkusCli().toAbsolutePath().toString(), "ext", "add", "resteasy-reactive", "openapi", "smallrye-openapi", "quarkus-smallrye-openapi", "--project-dir=" + outputDir.toAbsolutePath().toString() ); pb.redirectErrorStream(true); Process process = pb.start(); int exitCode = process.waitFor(); if (exitCode != 0) { output.print("添加扩展时出错。请检查输出以获取详细信息。"); // 您可能需要在此处记录进程输出。 } else { output.print("成功添加扩展。"); } } catch (IOException | InterruptedException e) { output.printStackTrace(e); output.print("添加扩展时出错: " + e.getMessage()); } } private void copySwaggerFile(QuarkusCommandInvocation invocation) throws IOException { // 将 Swagger 文件复制到项目的 resources 目录 Path resourcesDir = outputDir.resolve("src/main/resources"); Path swaggerDestination = resourcesDir.resolve("openapi.yaml"); // 或者 openapi.json java.nio.file.Files.createDirectories(resourcesDir); java.nio.file.Files.copy(Paths.get(swaggerFile), swaggerDestination, java.nio.file.StandardCopyOption.REPLACE_EXISTING); output.print("已将 Swagger 文件复制到: " + swaggerDestination.toAbsolutePath()); } private void generateRestEndpoints(QuarkusCommandInvocation invocation) { // 这是最复杂的部分。您需要使用像 swagger-codegen 或 OpenAPI Generator 这样的库 // 从 Swagger 文件生成 REST 端点。这通常涉及: // 1. 将必要的依赖项添加到项目 (例如，swagger-codegen-cli)。 // 2. 运行代码生成工具。 // 3. 处理代码生成过程中发生的任何错误。 // 这是一个占位符。您需要实现实际的代码生成。 // 以下是一个*概念性*示例: try { ProcessBuilder pb = new ProcessBuilder( "java", "-jar", "/path/to/openapi-generator-cli.jar", // 替换为实际路径 "generate", "-i", outputDir.resolve("src/main/resources/openapi.yaml").toAbsolutePath().toString(), "-g", "jaxrs-resteasy-reactive", // 或者您喜欢的生成器 "-o", outputDir.toAbsolutePath().toString() ); pb.redirectErrorStream(true); Process process = pb.start(); int exitCode = process.waitFor(); if (exitCode != 0) { output.print("生成 REST 端点时出错。请检查输出以获取详细信息。"); // 您可能需要在此处记录进程输出。 } else { output.print("成功生成 REST 端点。"); } } catch (IOException | InterruptedException e) { output.printStackTrace(e); output.print("生成 REST 端点时出错: " + e.getMessage()); } } private void buildProject(QuarkusCommandInvocation invocation) { // 使用 Maven 或 Gradle 构建项目 try { ProcessBuilder pb = new ProcessBuilder( "mvn", "clean", "package" // 或者 "gradlew clean build" ); pb.directory(outputDir.toFile()); pb.redirectErrorStream(true); Process process = pb.start(); int exitCode = process.waitFor(); if (exitCode != 0) { output.print("构建项目时出错。请检查输出以获取详细信息。"); // 您可能需要在此处记录进程输出。 } else { output.print("成功构建项目。"); } } catch (IOException | InterruptedException e) { output.printStackTrace(e); output.print("构建项目时出错: " + e.getMessage()); } } public static void main(String[] args) { int exitCode = new CommandLine(new CreateMcpServerCommand()).execute(args); System.exit(exitCode);

Model Context Protocol (MCP)

🚀 OpenClient - 基于 CLI 的通用 AI 应用连接器！一个开源的模型上下文协议 (MCP) 实现，通过上下文供应标准化来增强 LLM 的能力。使用我们的客户端快速连接您选择的服务器，以提升您的 AI 能力。非常适合创建下一代 AI 应用程序的开发者！

InfluxDB OSS API MCP Server

An MCP server that enables interactions with InfluxDB's open-source time-series database API, allowing data querying, management, and operations through natural language.

simple-mcp-runner

Simple MCP Runner makes it effortless to safely expose system commands to language models via a lightweight MCP server—all configurable with a clean, minimal YAML file and zero boilerplate.

Atlassian Bitbucket MCP Server

Atlassian Bitbucket MCP 服务器，用于自托管 Bitbucket 服务器。