MCP Tangent Server

A Model Context Protocol (MCP) server that provides fake documentation indexing and searching capabilities for Tangent. This server implements two main functions for managing documentation in a simulated knowledge base.

Features

• Documentation Indexing: Index new documentation with metadata, tags, and content
• Smart Search: Search through indexed documentation with filtering and relevance scoring
• Fake Data: Comes pre-loaded with sample documentation for testing
• MCP Compatible: Works with any MCP-compatible client

Installation

From npm (once published)

npm install -g mcp-tangent-server

From source

git clone <repository-url>
cd mcp-tangent-server
npm install

Usage

As a standalone server

npm start

In MCP client configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "tangent": {
      "command": "mcp-tangent-server"
    }
  }
}

Cursor IDE Integration

To use this MCP server with Cursor IDE, follow these steps:

Method 1: Global Configuration (Recommended)

1. Open Cursor Settings:

   • Open Cursor IDE
   • Click on the gear icon (⚙️) in the bottom left corner
   • Navigate to Features → Model Context Protocol

2. Add New MCP Server:

   • Click "Add MCP Server"
   • Configure as follows:

   Server Name: Tangent Documentation

   Command: mcp-tangent-server (if installed globally) or npx mcp-tangent-server

   Arguments: Leave empty []

3. Save and Restart:

   • Click "Save"
   • Restart Cursor to apply changes

Method 2: Configuration File

Alternatively, you can manually edit your Cursor MCP configuration:

1. Locate Configuration File:

   • macOS: ~/Library/Application Support/Cursor/User/globalStorage/cursor.mcp/config.json
   • Windows: %APPDATA%\Cursor\User\globalStorage\cursor.mcp\config.json
   • Linux: ~/.config/Cursor/User/globalStorage/cursor.mcp/config.json

2. Add Server Configuration:

   {
     "mcpServers": {
       "tangent-docs": {
         "command": "mcp-tangent-server",
         "args": []
       }
     }
   }

Method 3: Project-Specific Configuration

For project-specific usage, create a .cursor/mcp.json file in your project root:

{
  "mcpServers": {
    "tangent-docs": {
      "command": "npx",
      "args": ["mcp-tangent-server"]
    }
  }
}

Using the Server in Cursor

Once configured, you can use the documentation tools in Cursor's chat:

1. Index Documentation:

   @tangent Please index this documentation:
   Title: "API Authentication Guide"
   Content: "This guide explains how to authenticate with our API..."
   Tags: ["api", "auth", "security"]

2. Search Documentation:

   @tangent Search for documentation about "authentication" with tags "api"

3. Direct Tool Usage: The tools will also appear in Cursor's tool palette and can be invoked directly through the chat interface.

Verification

To verify the integration is working:

1. Open Cursor's chat panel
2. Type @ and you should see the Tangent server listed
3. The tools tangent_index_documentation and tangent_search_documentation should be available

Troubleshooting

• Server not appearing: Ensure the server is installed globally (npm install -g mcp-tangent-server) or use the full path to the executable
• Connection issues: Check that the command and arguments are correct in your configuration
• Permission errors: On macOS/Linux, ensure the executable has proper permissions (chmod +x)

Claude Desktop Integration

To use this MCP server with Claude Desktop:

1. Locate Claude Desktop Configuration:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add Server Configuration:

   {
     "mcpServers": {
       "tangent-docs": {
         "command": "mcp-tangent-server",
         "args": []
       }
     }
   }

3. Restart Claude Desktop and the server will be available in your conversations.

Other MCP Clients

This server is compatible with any MCP-compliant client. For other clients, use the following general configuration:

• Command: mcp-tangent-server
• Transport: stdio
• Arguments: [] (empty)

Available Tools

1. tangent_index_documentation

Index new documentation into the Tangent system.

Parameters:

• title (required): The title of the documentation
• content (required): The main content/body of the documentation
• url (optional): URL where the documentation can be accessed
• tags (optional): Array of tags for categorization
• metadata (optional): Additional metadata object

Example:

{
  "title": "API Authentication Guide",
  "content": "This guide explains how to authenticate with our API using JWT tokens...",
  "url": "https://docs.example.com/auth",
  "tags": ["api", "authentication", "security"],
  "metadata": {
    "author": "John Doe",
    "version": "1.2"
  }
}

2. tangent_search_documentation

Search through indexed documentation with various filters.

Parameters:

• query (required): Search query string
• tags (optional): Array of tags to filter by
• limit (optional): Maximum number of results (default: 10, max: 100)
• include_content (optional): Whether to include full content in results (default: true)

Example:

{
  "query": "authentication",
  "tags": ["api", "security"],
  "limit": 5,
  "include_content": true
}

Sample Data

The server comes pre-loaded with sample documentation including:

• Getting Started with Tangent
• Advanced Search Features
• API Integration Guide
• Troubleshooting Common Issues
• Best Practices for Documentation

Development

Running in development mode

npm run dev

This will start the server with Node.js inspector enabled for debugging.

Testing the server

You can test the server using any MCP client or by running it directly and sending JSON-RPC messages via stdin/stdout.

Architecture

The server uses:

• @modelcontextprotocol/sdk: For MCP protocol implementation
• In-memory storage: Fake database for documentation (resets on restart)
• Simple search: Text-based search with relevance scoring
• JSON-RPC: Communication protocol over stdio

API Response Format

Index Documentation Response

Successfully indexed documentation: "Your Title"

Document Details:
- ID: doc1234567890_abcdefghi
- Title: Your Title
- Content Length: 150 characters
- Tags: api, guide
- URL: https://example.com
- Indexed At: 2024-01-15T10:30:00Z

Search Documentation Response

Search Results for: "your query"

Found 3 matching documents (filtered by tags: api, guide)
Search completed in ~50ms

📄 **Document Title** (ID: doc123)
   🔗 URL: https://example.com
   🏷️ Tags: api, guide
   📅 Updated: 2024-01-15T10:30:00Z
   ⭐ Relevance: 85.50
   📝 Content: This is the beginning of the document content...

License

MIT

Changelog

Version 1.0.2

• Refactored server architecture following MCP best practices
• Improved error handling with proper validation and standardized error codes
• Better code organization with modular structure and clear separation of concerns
• Enhanced performance with optimized search algorithms
• Proper signal handling for graceful shutdowns
• Standardized tool naming following MCP conventions
• Comprehensive input validation for all parameters
• Improved logging and error reporting

Version 1.0.1

• Fixed tool naming to match client expectations
• Updated documentation with correct tool names

Version 1.0.0

• Initial release with basic indexing and search functionality

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

Support

For issues and questions, please open an issue on the GitHub repository.