A favicon of Dixa MCP Server

Dixa MCP Server

Manage conversations and tags efficiently with our server. Utilize resources to search and retrieve conversation details, notes, and messages. Enhance your workflow by adding or removing tags from conversations seamlessly.

Installation

Installing for Claude Desktop

Manual Configuration Required

This MCP server requires manual configuration. Run the command below to open your configuration file:

npx mcpbar@latest edit -c claude

This will open your configuration file where you can add the Dixa MCP Server MCP server manually.

Dixa MCP Server

A FastMCP server implementation for the Dixa API, providing resources and tools for managing conversations and tags.

Features

  • Resources

    • Search conversations
    • Get conversation details
    • Get conversation notes
    • Get conversation messages
    • Get available tags
  • Tools

    • Add tags to conversations
    • Remove tags from conversations

Project Structure

/src
├── dixa.ts              # Main server setup
├── config.ts            # Configuration and environment settings
├── types.ts             # Shared types and error handling
├── resources/           # Resource implementations
├── schemas/            # Zod schemas for validation
└── tools/             # Tool implementations

Configuration

The server requires the following environment variables:

  • DIXA_API_KEY: Your Dixa API key
  • DIXA_API_BASE_URL (optional): Override the default API URL (defaults to 'https://dev.dixa.io/v1')

Usage

  1. Set up environment variables:
   export DIXA_API_KEY='your-api-key'
  1. Start the server:
    npm start
    

## Running Your Server

### Test with `mcp-cli`

The fastest way to test and debug your server is with `fastmcp dev`:

```bash
npx fastmcp dev server.js
npx fastmcp dev server.ts

This will run your server with mcp-cli for testing and debugging your MCP server in the terminal.

Inspect with MCP Inspector

Another way is to use the official MCP Inspector to inspect your server with a Web UI:

npx fastmcp inspect server.ts

FAQ

How to use with Claude Desktop?

Follow the guide https://modelcontextprotocol.io/quickstart/user and add the following configuration:

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "npx",
      "args": [
        "tsx",
        "/PATH/TO/YOUR_PROJECT/src/index.ts"
      ],
      "env": {
        "YOUR_ENV_VAR": "value"
      }
    }
  }
}

Development

Adding a New Resource

  1. Create a schema in src/schemas/
  2. Create the resource in src/resources/
  3. Add the resource to src/dixa.ts

Example resource:

export const myResource = {
  uri: "dixa://my-resource",
  name: "My Resource",
  description: "Description",
  load: async (args: MyArgs, apiKey: string) => {
    // Implementation
  }
};

Adding a New Tool

  1. Create the tool in src/tools/
  2. Add the tool to src/dixa.ts

Example tool:

export const myTool = {
  name: "My Tool",
  description: "Description",
  execute: async (args: MyArgs, apiKey: string) => {
    // Implementation
  }
};

Error Handling

The project uses custom error classes:

  • DixaError: Base error class for API errors
  • DixaValidationError: For response validation failures

Showcase

[!NOTE]

If you've developed a server using FastMCP, please submit a PR to showcase it here!

Acknowledgements

Contributing

  1. Follow the existing patterns for resources and tools
  2. Add proper JSDoc documentation
  3. Use the shared utilities in types.ts and config.ts
  4. Update the README if adding new features
Share:
Details:
  • Stars


    0
  • Forks


    1
  • Last commit


    3 months ago
  • Repository age


    3 months
  • License


    MIT
View Repository

Auto-fetched from GitHub .

MCP servers similar to Dixa MCP Server:

 

 
 
  • Stars


  • Forks


  • Last commit


 

 
 
  • Stars


  • Forks


  • Last commit


 

 
 
  • Stars


  • Forks


  • Last commit


Dixa MCP Server: MCP Server – MCP.Bar