Skip to content
Back to search

mcp-usecase

Quick-start Auto MCP : All in one Claude Desktop and Cursor

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/teddynote-lab--mcp-usecase/badge.svg)](/listings/teddynote-lab--mcp-usecase)

HTML

<a href="/listings/teddynote-lab--mcp-usecase"><img src="/api/listings/teddynote-lab--mcp-usecase/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Clone the repository

git clone https://github.com/teddynote-lab/mcp.git
cd mcp

2. Set up virtual environment

Using uv (recommended)

# macOS/Linux
uv venv
uv pip install -r requirements.txt
# Windows
uv venv
uv pip install -r requirements_windows.txt

Using pip

python -m venv .venv

# Windows
.venv\Scripts\activate
pip install -r requirements_windows.txt

# macOS/Linux
source .venv/bin/activate

pip install -r requirements.txt

3. Preparing the PDF File

Plese prepare a PDF file required for RAG in the `./data` directory.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 167 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Quick-start Auto MCP : All in one Claude Desktop and Cursor
  2. [English](README.md) | [한국어](README_KR.md)
  3. ## Introduction
  4. **Quick-start Auto MCP** is a tool that helps you easily and quickly register Anthropic's Model Context Protocol (MCP) in Claude Desktop and Cursor.
  5. **Key advantages:**
  6. 1. **Quick Setup**: Add MCP functionality to Claude Desktop and Cursor simply by running a tool and copying/pasting the generated JSON file.
  7. 2. **Various Tools Provided**: We continuously update useful MCP tools. Stay up to date with your personalized toolkit by starring and following us. :)
  8. ## Table of Contents
  9. - [Features](#features)
  10. - [Project Structure](#project-structure)
  11. - [Requirements](#requirements)
  12. - [Installation](#installation)
  13. - [Configuration](#configuration)
  14. - [Usage](#usage)
  15. - [Troubleshooting](#troubleshooting)
  16. - [License](#license)
  17. - [Contributing](#contributing)
  18. - [Contact](#contact)
  19. - [Author](#author)
  20. ## Features
  21. - **RAG (Retrieval Augmented Generation)** - Keyword, semantic, and hybrid search functionality for PDF documents
  22. - **Dify External Knowledge API** - Document search functionality via Dify's external knowledge API
  23. - **Dify Workflow** - Execute and retrieve results from Dify Workflow
  24. - **Web Search** - Real-time web search using Tavily API
  25. - **Automatic JSON Generation** - Automatically generate MCP JSON files needed for Claude Desktop and Cursor
  26. ## Project Structure
  27. ```
  28. .
  29. ├── case1 # RAG example
  30. ├── case2 # Dify External Knowledge API example
  31. ├── case3 # Dify Workflow example
  32. ├── case4 # Web Search example
  33. ├── data # Example data files
  34. ├── docs # Documentation folder
  35. │ ├── case1.md # case1 description 🚨 Includes tips for optimized tool invocation
  36. │ ├── case2.md # case2 description
  37. │ ├── case3.md # case3 description
  38. │ ├── case4.md # case4 description
  39. │ └── installation.md # Installation guide
  40. ├── .env.example # .env example format
  41. ├── pyproject.toml # Project settings
  42. ├── requirements.txt # Required packages list
  43. └── uv.lock # uv.lock
  44. ```
  45. ## Requirements
  46. - Python >= 3.11
  47. - Claude Desktop or Cursor (MCP supporting version)
  48. - uv (recommended) or pip
  49. ## Installation
  50. ### 1. Clone the repository
  51. ```bash
  52. git clone https://github.com/teddynote-lab/mcp.git
  53. cd mcp
  54. ```
  55. ### 2. Set up virtual environment
  56. #### Using uv (recommended)
  57. ```bash
  58. # macOS/Linux
  59. uv venv
  60. uv pip install -r requirements.txt
  61. ```
  62. ```bash
  63. # Windows
  64. uv venv
  65. uv pip install -r requirements_windows.txt
  66. ```
  67. #### Using pip
  68. ```bash
  69. python -m venv .venv
  70. # Windows
  71. .venv\Scripts\activate
  72. pip install -r requirements_windows.txt
  73. # macOS/Linux
  74. source .venv/bin/activate
  75. pip install -r requirements.txt
  76. ```
  77. ### 3. Preparing the PDF File
  78. Plese prepare a PDF file required for RAG in the `./data` directory.
  79. ## Configuration
  80. In order to execute each case, a `.env` file is required.
  81. Please specify the necessary environment variables in the `.env.example` file located in the root directory, and rename it to `.env`.
  82. ### sites for configuring required environment variables for each case
  83. - https://platform.openai.com/api-keys
  84. - https://dify.ai/
  85. - https://app.tavily.com/home
  86. ## Usage
  87. ### 1. Generate JSON File
  88. Run the following command in each case directory to generate the necessary JSON file:
  89. ```bash
  90. # Activate virtual environment
  91. # Windows
  92. .venv\Scripts\activate
  93. # macOS/Linux
  94. source .venv/bin/activate
  95. # Navigate to example directory
  96. cd case1
  97. # Generate JSON file
  98. python auto_mcp_json.py
  99. ```
  100. ### 2. Register MCP in Claude Desktop/Cursor
  101. 1. Launch Claude Desktop or Cursor
  102. 2. Open MCP settings menu
  103. 3. Copy and paste the generated JSON content
  104. 4. Save and `restart` (If you're using Windows, we recommend fully closing the process via Task Manager and then restarting the application.)
  105. > **Note**: When you run Claude Desktop or Cursor, the MCP server will automatically run with it. When you close the software, the MCP server will also terminate.
  106. ## Troubleshooting
  107. Common issues and solutions:
  108. - **MCP Server Connection Failure**: Check if the service is running properly and if there are no port conflicts. In particular, when applying case2, you must also run `dify_ek_server.py`.
  109. - **API Key Errors**: Verify that environment variables are set correctly.
  110. - **Virtual Environment Issues**: Ensure Python version is 3.11 or higher.
  111. ## License
  112. [MIT LICENSE](LICENSE.md)
  113. ## Contributing
  114. Contributions are always welcome! Please participate in the project through issue registration or pull requests. :)
  115. ## Contact
  116. If you have questions or need help, please register an issue or contact:
  117. dev@brain-crew.com
  118. ## Author
  119. [Hantaek Lim](https://github.com/LHANTAEK)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.