This TypeScript implementation of a Model Context Protocol (MCP) server allows you to expose your Dify workflows as tools. By converting Dify applications into MCP tools, you can leverage their capabilities in compatible clients like Claude Desktop.
The easiest way to install the Dify MCP Server is through Smithery:
npx -y @smithery/cli install @faiz-gear/dify-mcp-server-ts --client claude
For manual installation, follow these steps:
Clone the repository:
git clone <repository-url>
cd dify-mcp-server-ts
Install dependencies:
npm install
Create a configuration file:
# config.yaml
dify_base_url: 'https://api.dify.ai/v1'
dify_app_sks:
- 'your-dify-app-sk-1' # Replace with your actual Dify app secret key
- 'your-dify-app-sk-2' # Replace with your actual Dify app secret key
The server uses a YAML file for configuration. By default, it looks for config.yaml
in the project root directory.
dify_base_url
: The base URL for the Dify APIdify_app_sks
: A list of Dify application secret keys that you want to expose as toolsYou can specify a different configuration file path using the CONFIG_PATH
environment variable.
After installation and configuration:
Build the project:
npm run build
Start the server:
npm start
For development purposes, you can run the server in development mode:
npm run dev
Before installing, ensure you have:
There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json
file so that it is available in all of your projects.
If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json
file.
To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".
When you click that button the ~/.cursor/mcp.json
file will be opened and you can add your server like this:
{
"mcpServers": {
"cursor-rules-mcp": {
"command": "npx",
"args": [
"-y",
"cursor-rules-mcp"
]
}
}
}
To add an MCP server to a project you can create a new .cursor/mcp.json
file or add it to the existing one. This will look exactly the same as the global MCP server example above.
Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.
The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.
You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.