Skip to content

Update Readme and Server version to 0.2.0 #22

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jun 12, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 27 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,30 @@
# DevRev MCP server
# DevRev MCP Server

## Overview

A Model Context Protocol server for DevRev. It is used to search and retrieve information using the DevRev APIs.
A Model Context Protocol server for DevRev. This server provides comprehensive access to DevRev's APIs, allowing you to manage work items (issues, tickets), parts (enhancements), search across your DevRev data, and retrieve user information.

## Tools

- `search`: Search for information using the DevRev search API with the provided query and namespace.
- `get_object`: Get all information about a DevRev issue or ticket using its ID.
- `create_object`: Create a new issue or ticket in DevRev with specified properties.
- `update_object`: Update an existing issue or ticket in DevRev by modifying its title or body content.
### Search & Discovery
- **`search`**: Search for information across DevRev using the search API with support for different namespaces (articles, issues, tickets, parts, dev_users, accounts, rev_orgs).
- **`get_current_user`**: Fetch details about the currently authenticated DevRev user.

### Work Items (Issues & Tickets)
- **`get_work`**: Get comprehensive information about a specific DevRev work item using its ID.
- **`create_work`**: Create new issues or tickets in DevRev with specified properties like title, body, assignees, and associated parts.
- **`update_work`**: Update existing work items by modifying properties such as title, body, assignees, or associated parts.
- **`list_works`**: List and filter work items based on various criteria like state, dates, assignees, parts, and more.

### Parts (Enhancements)
- **`get_part`**: Get detailed information about a specific part (enhancement) using its ID.
- **`create_part`**: Create new parts (enhancements) with specified properties including name, description, assignees, and parent parts.
- **`update_part`**: Update existing parts by modifying properties such as name, description, assignees, or target dates.
- **`list_parts`**: List and filter parts based on various criteria like dates, assignees, parent parts, and more.

## Configuration

### Get the DevRev API key
### Get the DevRev API Key

1. Go to https://app.devrev.ai/signup and create an account.
2. Import your data from your existing data sources like Salesforce, Zendesk while following the instructions [here](https://devrev.ai/docs/import#available-sources).
Expand Down Expand Up @@ -65,3 +76,12 @@ On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
```

</details>

## Features

- **Comprehensive Work Item Management**: Create, read, update, and list both issues and tickets
- **Enhanced Part Management**: Full CRUD operations for parts (enhancements) including hierarchical relationships
- **Advanced Search**: Search across multiple namespaces with hybrid search capabilities
- **Flexible Filtering**: Advanced filtering options for listing work items and parts based on dates, assignees, states, and more
- **User Context**: Access to current user information for personalized experiences
- **Rich Data Support**: Handle complex relationships between work items, parts, users, and organizations
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "devrev-mcp"
version = "0.1.2"
version = "0.2.0"
description = "A MCP server project"
readme = "README.md"
requires-python = ">=3.11"
Expand Down
2 changes: 1 addition & 1 deletion src/devrev_mcp/server.py
Original file line number Diff line number Diff line change
Expand Up @@ -803,7 +803,7 @@ async def main():
write_stream,
InitializationOptions(
server_name="devrev_mcp",
server_version="0.1.2",
server_version="0.2.0",
capabilities=server.get_capabilities(
notification_options=NotificationOptions(),
experimental_capabilities={},
Expand Down