Skip to content

mcp-server.md

Latest commit

 

History

History
132 lines (99 loc) · 2.94 KB

mcp-server.md

File metadata and controls

132 lines (99 loc) · 2.94 KB
Raw

MCP Server Configuration

mcptools can run as an MCP (Model Context Protocol) server.

Transport Modes

stdio (Local Agents)

mcptools mcp stdio

For local agents like Claude Desktop that communicate via stdin/stdout.

SSE (Web Clients)

mcptools mcp sse --port 3000 --host 127.0.0.1

For web-based clients using Server-Sent Events over HTTP.

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mcptools": {
      "command": "mcptools",
      "args": ["mcp", "stdio"]
    }
  }
}

Claude Code Configuration

Using CLI:

claude mcp add mcptools -- mcptools mcp stdio

Or manually add to ~/Library/Application Support/Claude/claude_code_config.json:

{
  "mcpServers": {
    "mcptools": {
      "command": "mcptools",
      "args": ["mcp", "stdio"]
    }
  }
}

Available MCP Tools

Atlassian

Tool Description
jira_search Search Jira issues using JQL
jira_get Get Jira ticket details
jira_create Create a new Jira ticket
jira_update Update Jira ticket fields
jira_query_list List saved queries
jira_query_save Save a JQL query
jira_query_delete Delete a saved query
jira_query_load Load a saved query
confluence_search Search Confluence pages
bitbucket_pr_list List Bitbucket PRs
bitbucket_pr_read Read PR details/diff

HackerNews

Tool Description
hn_read_item Read post and comments
hn_list_items List stories

Web Scraping

Tool Description
md_fetch Fetch page as Markdown
md_toc Extract table of contents

Strand

Tool Description
generate_code Generate Rust code via local Ollama model

PDF

Tool Description
pdf_toc Parse document tree / table of contents
pdf_read Read section content as Markdown
pdf_peek Sample text snippet from section
pdf_images List images in section or document
pdf_image Extract specific image by ID
pdf_info Get document metadata

UI Annotations

Tool Description
ui_annotations_list List all annotations
ui_annotations_get Get annotation by ID
ui_annotations_resolve Mark annotation as resolved
ui_annotations_clear Clear all annotations

Testing with curl

# Start MCP server
mcptools mcp sse --port 3000

# Test tools/list
curl -X POST http://127.0.0.1:3000/message \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# Test a tool call
curl -X POST http://127.0.0.1:3000/message \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"hn_list_items","arguments":{"limit":5}}}'