craftgate_mcp_server
Bu MCP sunucu projesinde, Craftgate’in ödeme listeleme aracı entegre edilmiştir. Bu araç sayesinde ödemeler sorgulanabilir ve ödemeler hakkında LLM (Large Language Model) desteğiyle analiz yapılabilir.
claude mcp add --transport stdio semihshn-craftgate_mcp_server java -Dspring.ai.mcp.server.stdio=true -jar /path/to/build/libs/mcp_craftgate-0.0.1-SNAPSHOT.jar \ --env CRAFTGATE_API_KEY="your-api-key" \ --env CRAFTGATE_BASE_URL="https://sandbox-api.craftgate.io" \ --env CRAFTGATE_SECRET_KEY="your-secret-key"
How to use
This MCP server integrates Craftgate payments within the MCP ecosystem. It is built with Spring Boot and exposes endpoints to query Craftgate payment data, generate reports, and manage related payment operations through the MCP protocol. The server runs as a standalone Java application and can be started via the provided JAR. With the -Dspring.ai.mcp.server.stdio=true option, the server communicates in a way that aligns with MCP standard I/O semantics, facilitating seamless interaction within an MCP environment. You can use the MCP configuration to launch the JAR, and then use your MCP orchestration layer to route requests to this Craftgate MCP server for payment lookups, status checks, and reporting tasks.
How to install
Prerequisites:
- Java 17 or higher
- Gradle (or use the included gradlew wrapper)
- Internet access to fetch dependencies
Steps:
- Clone or download the repository for the Craftgate MCP server.
- Configure API keys in the application properties (optional if you prefer environment variables):
src/main/resources/application.properties
craftgate.api-key=dummy-api-key
craftgate.secret-key=dummy-secret-key
craftgate.base-url=https://sandbox-api.craftgate.io
- Build the project (use the wrapper or your local Gradle):
./gradlew clean build
- Windows:
gradlew.bat clean build
- Locate the generated JAR (example path):
build/libs/mcp_craftgate-0.0.1-SNAPSHOT.jar
- Run the server:
java -jar build/libs/mcp_craftgate-0.0.1-SNAPSHOT.jar
- Optional MCP configuration snippet to start the JAR via MCP environment:
"craftgate-mcp": {
"command": "java",
"args": [
"-Dspring.ai.mcp.server.stdio=true",
"-jar",
"/tam/yol/build/libs/mcp_craftgate-0.0.1-SNAPSHOT.jar"
]
}
- Verify the server starts and is reachable through your MCP orchestrator. Check logs for any startup errors and ensure the configured port is not in use.
Additional notes
Tips and common considerations:
- Ensure your Craftgate API keys are valid and have the necessary permissions for the operations you intend to perform.
- If you modify application.properties, you can switch between sandbox and production Craftgate endpoints by changing craftgate.base-url accordingly.
- The MCP config example uses -Dspring.ai.mcp.server.stdio=true to ensure MCP-compatible I/O. Adjust this if your deployment environment requires different I/O handling.
- The generated JAR path in the MCP config must reflect the actual deployment path on the host running the MCP environment.
- For troubleshooting, consult the log file location described in the README or your MCP host's logging configuration.
- If you update dependencies, re-run the Gradle build to produce a fresh JAR.
