{"id":"inkdropapp-mcp-server","name":"mcp-server","homepage":null,"repo_url":"https://github.com/inkdropapp/mcp-server","category":"devtools","subcategories":[],"tags":["mcp","model-context-protocol","inkdrop","notes","local-http","agent-tools","nodejs"],"what_it_does":"Provides an MCP (Model Context Protocol) server that exposes Inkdrop’s Local HTTP Server API as MCP tools, enabling agents to list/search/read/create/update/patche notes, notebooks, and tags via stdio.","use_cases":["Agent-assisted note retrieval and summarization from an Inkdrop local database","Keyword search and filtering of Inkdrop notes (with follow-up reads for full content)","Automated note creation/updating in Inkdrop from a conversational workflow","Tag/book management for structured knowledge organization in Inkdrop"],"not_for":["Using as a public remote API service (it is intended to connect to a local Inkdrop Local HTTP Server)","Handling sensitive notes without properly securing the local Inkdrop HTTP server and credentials","Bulk high-volume operations without considering rate limits and performance constraints"],"best_when":"You have Inkdrop running with the Local HTTP Server enabled and you want agent tool access through MCP (e.g., Claude Desktop + MCP Inspector).","avoid_when":"You cannot control/secure the local endpoint (host/port, credentials) or you need strong auditability/authorization beyond the local server’s capabilities.","alternatives":["Direct integration with Inkdrop Local HTTP Server API from your own code","Using a different knowledge-note MCP server or a generic MCP tool for local file/DB access","Building an MCP wrapper around Inkdrop’s REST API with custom auth and stricter policies"],"af_score":59.2,"security_score":43.0,"reliability_score":33.8,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:22:31.455667+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Local HTTP server credentials via environment variables: INKDROP_LOCAL_USERNAME and INKDROP_LOCAL_PASSWORD"],"oauth":false,"scopes":false,"notes":"Auth is delegated to the Inkdrop Local HTTP Server. The MCP server configuration passes local username/password via env vars."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information provided; appears to be a local/open-source style integration."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":59.2,"security_score":43.0,"reliability_score":33.8,"mcp_server_quality":85.0,"documentation_accuracy":75.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":65.0,"rate_limit_clarity":20.0,"tls_enforcement":30.0,"auth_strength":55.0,"scope_granularity":10.0,"dependency_hygiene":55.0,"secret_handling":65.0,"security_notes":"Uses username/password for the local HTTP server passed via environment variables. No evidence provided about TLS enforcement, fine-grained scopes, or safe logging practices. Since it connects to a local endpoint, security largely depends on how the local server is configured (HTTPS vs HTTP, network exposure) and whether credentials are protected from logs/process inspection.","uptime_documented":0.0,"version_stability":65.0,"breaking_changes_history":30.0,"error_recovery":40.0,"idempotency_support":"false","idempotency_notes":"No explicit idempotency guarantees documented. Some operations (create/update/patch) may not be idempotent depending on server semantics.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Tool results like search/list notes appear to include truncated note bodies (200 chars); agents should call read-note for full content.","Some update operations require CouchDB-style MVCC fields (e.g., _rev for update-tag/update-note/patch-note), so agents must first read to get the current revision before updating.","For patch-note, old_string must match exactly one occurrence with sufficient surrounding context; otherwise the patch may fail."]}}