MCP Server Notion Prompt

🚀 Notion Prompt MCP Server

This is a server based on the Model Context Protocol (MCP) standard, which provides access to prompts stored in a Notion database.

✨ Features

• Prompt Resource List: Offers all available prompts in the form of MCP resources.
• Prompt Reading Function: Retrieves a specific prompt by its name.
• Prompt Combination Processing: Combines user input with prompt templates.
• Multi - mode Processing Support: Supports various processing modes such as direct use, category - based invocation, and self - selection.
• Intelligent Refresh Mechanism: Allows cache refreshing to ensure up - to - date data.
• Classification Management Function: Organizes and retrieves prompts by category.
• Advanced Search Function: Searches for prompts by name, description, or content.

📦 Installation

# Run the development version
npm run dev

# Build the project
npm run build

# Run tests
npm test

🛠️ Configuration

Specific steps to create a Notion integration and database:

1. Obtain an API access token:

   • Log in to Notion.
   • Navigate to the "Integrations" page to set up and obtain the access token.

2. Create a prompt database:

   • Create a new database in Notion.
   • Set the necessary fields: Name, Content, Description, and Category.

Server Configuration Parameters

• NOTION_API_KEY: The Notion API access token for authentication.
• NOTION_DATABASE_ID: The unique identifier of the prompt database.

🛠️ Processing Modes

Basic Usage

Direct Processing

{
  "command": "process_with_prompt",
  "args": ["Translation Assistant", "Hello, I am learning to use Cursor with MCP."]
}

Category - based Invocation

{
  "command": "category_process",
  "args": ["Seven Weapons", "Just read the news, no discussions~"]
}

Self - selection

{
  "command": "ai_choice",
  "args": ["Life, Love and Laughter (Osho)", "Seven Weapons", "Just read the news, no discussions~"]
}

📋 Notion Database Structure

• Name: The name of the prompt.
• Content: The content of the prompt template.
• Description: The description of the prompt.
• Category: The category to which the prompt belongs.

🪧 Prompt Variables

• {{USER_INPUT}}: The content input by the user.
• {{PROMPT_NAME}}: The name of the current prompt.
• Other placeholders can be customized according to specific requirements.

🛠️ MCP Tools

1. list_prompts: Lists all available prompts.
2. get_prompt_by_name: Retrieves a prompt by its name.
3. compose_prompt: Integrates user input with prompt templates.
4. process_composed_prompt: Processes the combined prompt.
5. process_category_prompts: Processes all prompts in a specified category.
6. refresh_prompts: Refreshes the prompt cache.
7. get_prompts_by_category: Retrieves prompts in a specific category.
8. search_prompts: Searches for prompts by name, description, or content.
9. list_categories: Lists all available prompt categories.

💻 Usage Examples

Basic Usage

Get a Specific Prompt

{
  "command": "get_prompt_by_name",
  "args": ["Translation Assistant"]
}

Combine a Prompt with User Input

{
  "command": "compose_prompt",
  "args": ["Translation Assistant", "Hello, I am learning to use Cursor with MCP."]
}

Directly Process Content with a Prompt

{
  "command": "process_with_prompt",
  "args": ["Translation Assistant", "Hello, I am learning to use Cursor with MCP."]
}

Refresh the Cache

{
  "command": "refresh_prompts"
}

Invoke Prompts by Category

{
  "command": "category_process",
  "args": ["Seven Weapons", "Just read the news, no discussions~"]
}

Combine Category Output

{
  "command": "compose_category_output",
  "args": ["Seven Weapons", "Just read the news, no discussions~"]
}

AI Self - selection

{
  "command": "ai_choice",
  "args": ["Life, Love and Laughter (Osho)", "Seven Weapons", "Just read the news, no discussions~"]
}

⚙️ Server Configuration Example

{
  "commands": {
    "process_with_prompt": {
      "type": "prompt_process",
      "params": {
        "api_key": "{{NOTION_API_KEY}}",
        "database_id": "{{NOTION_DATABASE_ID}}"
      }
    },
    "category_process": {
      "type": "category_batch",
      "params": {
        "api_key": "{{NOTION_API_KEY}}",
        "database_id": "{{NOTION_DATABASE_ID}}"
      }
    },
    "ai_choice": {
      "type": "ai_decision",
      "params": {
        "api_key": "{{NOTION_API_KEY}}",
        "database_id": "{{NOTION_DATABASE_ID}}"
      }
    }
  }
}

📄 License

[Your License Here]

📞 Contact

[Your Contact Information]