The server uses the metoro-io/mcp-golang package with an HTTP transport layer (port 8080) to comply with the requirement for an HTTP-based REST API.
A resource endpoint (info://server) is registered to provide metadata about the server, including its name, version, and available actions (, , ). This allows MCP clients to discover the server's capabilities.
go-mcp-jira-server created completely with [grok](https://grok.com), with credits of my prompts!
ดาว
1
เครื่องมือ
—
อัปไทม์
—
create_issue
update_issue
search_issues
Jira Client
The JiraClient struct encapsulates Jira API interactions and determines whether the instance is Jira Cloud (based on .atlassian.net in the URL) or Data Center.
Authentication is handled differently:
Jira Cloud: Uses Basic Auth with the user's email and API key.
Data Center: Uses a Bearer token with the API key (Personal Access Token).
The getBaseAPIPath method selects the appropriate API path (/rest/api/3 for Cloud, /rest/api/2 for Data Center) to handle endpoint differences.
Supported Actions
Create Issue:
Accepts jira_config, project_key, summary, description, and issue_type.
Sends a POST request to the Jira API's issue endpoint.
Returns the created issue key (e.g., PROJ-123).
Update Issue:
Accepts jira_config, issue_key, summary, and description.
Sends a PUT request to update the specified issue.
Returns the updated issue key.
Search Issues:
Accepts jira_config and jql query (e.g., project = PROJ AND status = Open).
Sends a GET request to the search endpoint with the JQL query.
Returns a list of issues with their keys and summaries.
MCP Tools
Each action is registered as an MCP tool with JSON schema annotations to define required and optional fields, following the MCP specification.
Tools return responses in the MCP format using mcp_golang.NewToolResponse.
Security and Configuration
The JiraConfig struct holds the Jira URL, API key, and email (for Cloud authentication).
For this example, the configuration is hardcoded in the tool handlers. In a production environment, you should load these from environment variables or a configuration file for security.
Error Handling
The code includes comprehensive error handling for HTTP requests, JSON marshaling/unmarshaling, and API responses.
Non-successful HTTP status codes result in descriptive error messages.
Configure your MCP client to send requests with the jira_config fields as shown in the example payloads.
Verify that the server correctly processes the Jira URL, email, and API key for each request.
Additional Considerations
Security
Transmitting API keys in every request requires secure communication (e.g., HTTPS). Ensure the server is configured to use TLS in production.
Consider validating the provided Jira URL (e.g., checking for valid domains) to prevent misuse.
Error Handling
The existing error handling in JiraClient will catch issues like invalid URLs or credentials. You may want to add specific validation for the JiraConfig fields (e.g., ensuring the URL is well-formed or the email is valid for Cloud instances).
Performance
Creating a new JiraClient for each request is simple but may introduce overhead. If performance becomes an issue, consider caching clients for frequently used configurations (e.g., using a map keyed by URL and email).
Jira Data Center
For Data Center, the email field may not be required, as authentication typically uses only the API token. You could make the email field optional in the JiraConfig struct and skip Basic Auth for Data Center instances, but the current code works as is since the JiraClient handles authentication appropriately.
Testing
To test the updated server:
Use a tool like curl or an MCP client to send requests with the `jira_config` fields.
Verify that the server correctly processes different Jira URLs (Cloud and Data Center) and authentication credentials.
Check that the actions (create_issue, update_issue, search_issues) return the expected results.
For example, to test create_issue with curl (assuming the MCP server supports raw HTTP POST for testing):
bash
-H "Content-Type: application/json" \
-d '{
"jira_config": {
"url": "https://your-jira-instance.atlassian.net",
"api_key": "your-api-key",
"email": "[email protected]"
},
"project_key": "PROJ",
"summary": "Test Issue",
"description": "This is a test",
"issue_type": "Task"
}'```
### Client examples
### Example Client Requests
Below are example JSON payloads for each action:
**Create Issue**
```json
{
"function": "create_issue",
"parameters": {
"jira_config": {
"url": "https://your-jira-instance.atlassian.net",
"api_key": "your-api-key",
"email": "[email protected]"
},
"project_key": "PROJ",
"summary": "Test Issue",
"description": "This is a test issue created via MCP",
"issue_type": "Task"
}
}