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
Related MCP server: ReActMCP Web Search
Project Structure
Configuration
The server requires the following environment variables:
DIXA_API_KEY: Your Dixa API keyDIXA_API_BASE_URL(optional): Override the default API URL (defaults to 'https://dev.dixa.io/v1')
Usage
Set up environment variables:
Start the server:
npm start
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:
FAQ
How to use with Claude Desktop?
Follow the guide https://modelcontextprotocol.io/quickstart/user and add the following configuration:
Development
Adding a New Resource
Create a schema in
src/schemas/Create the resource in
src/resources/Add the resource to
src/dixa.ts
Example resource:
Adding a New Tool
Create the tool in
src/tools/Add the tool to
src/dixa.ts
Example tool:
Error Handling
The project uses custom error classes:
DixaError: Base error class for API errorsDixaValidationError: For response validation failures
Showcase
If you've developed a server using FastMCP, please submit a PR to showcase it here!
https://github.com/apinetwork/piapi-mcp-server
https://github.com/Meeting-Baas/meeting-mcp - Meeting BaaS MCP server that enables AI assistants to create meeting bots, search transcripts, and manage recording data
Acknowledgements
FastMCP is inspired by the Python implementation by Jonathan Lowin.
Parts of codebase were adopted from LiteMCP.
Parts of codebase were adopted from Model Context protocolでSSEをやってみる.
Contributing
Follow the existing patterns for resources and tools
Add proper JSDoc documentation
Use the shared utilities in
types.tsandconfig.tsUpdate the README if adding new features