AI助手开发工具集

# Clone the repository
git clone https://github.com/Deejpotter/my-mcp-server.git
cd my-mcp-server

# Install dependencies
npm install

# Build the server
npm run build

{
  "servers": {
    "my-mcp-server": {
      "command": "npm",
      "args": [
        "--prefix",
        "~/Repos/my-mcp-server",
        "start"
      ],
      "env": {}
    }
  }
}

{
  "servers": {
    "my-mcp-server": {
      "command": "npm",
      "args": [
        "--prefix",
        "~/Repos/my-mcp-server",
        "run",
        "dev"
      ],
      "env": {}
    }
  }
}

# Context7 - Optional for enhanced documentation
CONTEXT7_API_KEY=your_context7_key_here

# Hugging Face - Required for AI image generation
HUGGING_FACE_API_KEY=your_hugging_face_key_here

# OpenAI - Required for PDF receipt extraction tools
OPENAI_API_KEY=your_openai_key_here

# Maker Image Converter - Optional local repo path override
MAKER_IMAGE_CONVERTER_ROOT=C:/Users/Deej/Repos/maker-image-converter

# Local Knowledge System - Optional override for the local multi-database knowledge project
LOCAL_KNOWLEDGE_ROOT=C:/Users/Deej/krasus/projects/local-knowledge-system

{
  "servers": {
    "my-mcp-server": {
      "command": "npm",
      "args": [
        "--prefix",
        "~/Repos/my-mcp-server",
        "start"

      - **image_analyze_color_profile** ‚ÄĒ Analyze reference images and save a reusable color profile
        - Run **once** against your "gold standard" images to capture their R/G/B channel statistics
        - Saves a `color-profile.json` file (mean + stdev per channel) that can be reused indefinitely
        - Workflow step 1: point at the good images ‚Üí profile is saved to disk

      - **image_color_correct** ‚ÄĒ Correct image color levels using a saved profile
        - Run whenever you have new images that need fixing
        - Loads the JSON profile and applies a per-channel linear transform to match the expected levels
        - Adjustable `strength` (0.0‚Äď1.0), output quality, and format options
        - Workflow step 2: point at bad images + provide profile path ‚Üí corrected images output
### **Web Search**

- **duckduckgo_search** - Search DuckDuckGo for web results

Best for active development. Runs TypeScript directly with hot reload.

**Requirements:** Only needs `npm install` (no build step).

```json
{
  "servers": {
    "my-mcp-server": {
      "command": "npm",
      "args": [
        "--prefix",
        "~/Repos/my-mcp-server",
        "run",
        "dev"
      ],
      "env": {}
    }
  }
}

{
  "type": "stdio",
  "command": "node",
  "args": [
    "C:/Users/YourUserName/Repos/my-mcp-server/dist/server.js"
  ],
  "active": true
}

# Context7 - Optional for enhanced documentation lookup
# Get your key from: https://context7.com
CONTEXT7_API_KEY=your_context7_key_here

# Coles API ‚ÄĒ Required for Coles product search
COLES_API_KEY=your_coles_subscription_key_here

# BookStack - Required for BookStack tools
# Create tokens in your BookStack instance: Settings > API Tokens
BOOKSTACK_URL=https://your-bookstack-instance.com
BOOKSTACK_TOKEN_ID=your_token_id_here
BOOKSTACK_TOKEN_SECRET=your_token_secret_here

# ClickUp - Required for ClickUp tools
# Get your token from: https://app.clickup.com/settings/apps
CLICKUP_API_TOKEN=your_clickup_token_here

# GitHub - Optional for enhanced code search
# Create at: https://github.com/settings/tokens
GITHUB_TOKEN=your_github_token_here

# OpenAI ‚ÄĒ Required for PDF receipt extraction tools
OPENAI_API_KEY=your_openai_key_here

# Maker Image Converter - Optional local repo path override
MAKER_IMAGE_CONVERTER_ROOT=C:/Users/Deej/Repos/maker-image-converter

my-mcp-server/
‚Ēú‚ĒÄ‚ĒÄ src/
‚Ēā   ‚Ēú‚ĒÄ‚ĒÄ server.ts              # Main MCP server entry point
‚Ēā   ‚Ēú‚ĒÄ‚ĒÄ tools/                 # MCP tool implementations
‚Ēā   ‚Ēā   ‚Ēú‚ĒÄ‚ĒÄ fileTools.ts       # File read/write/list operations
‚Ēā   ‚Ēā   ‚Ēú‚ĒÄ‚ĒÄ commandTools.ts    # Command execution and security
‚Ēā   ‚Ēā   ‚Ēú‚ĒÄ‚ĒÄ gitTools.ts        # Git command operations
‚Ēā   ‚Ēā   ‚Ēú‚ĒÄ‚ĒÄ duckduckgoSearchTools.ts # DuckDuckGo web search
‚Ēā   ‚Ēā   ‚Ēú‚ĒÄ‚ĒÄ context7Tools.ts   # Context7 docs lookup/search
‚Ēā   ‚Ēā   ‚Ēú‚ĒÄ‚ĒÄ clickupTools.ts    # ClickUp integration
‚Ēā   ‚Ēā   ‚Ēú‚ĒÄ‚ĒÄ imageTools.ts      # Image generate/convert/resize/optimize
‚Ēā   ‚Ēā   ‚ĒĒ‚ĒÄ‚ĒÄ pdfTools.ts        # PDF receipt extraction tools
‚Ēā   ‚Ēú‚ĒÄ‚ĒÄ resources/             # MCP resources (read-only data)
‚Ēā   ‚Ēā   ‚ĒĒ‚ĒÄ‚ĒÄ gitResources.ts    # Git repository status
‚Ēā   ‚Ēú‚ĒÄ‚ĒÄ prompts/
‚Ēā   ‚Ēā   ‚ĒĒ‚ĒÄ‚ĒÄ prompts.ts         # MCP-registered workflow prompts
‚Ēā   ‚ĒĒ‚ĒÄ‚ĒÄ utils/                 # Shared utility functions
‚Ēā       ‚Ēú‚ĒÄ‚ĒÄ security.ts        # Security validation and checks
‚Ēā       ‚Ēú‚ĒÄ‚ĒÄ cache.ts           # Caching and rate limiting
‚Ēā       ‚ĒĒ‚ĒÄ‚ĒÄ performance.ts     # Performance tracking
‚Ēú‚ĒÄ‚ĒÄ dist/                      # Compiled JavaScript (generated by build)
‚Ēú‚ĒÄ‚ĒÄ package.json               # Node.js dependencies and scripts
‚Ēú‚ĒÄ‚ĒÄ tsconfig.json              # TypeScript compiler configuration
‚Ēú‚ĒÄ‚ĒÄ .eslintrc.json             # ESLint code quality rules
‚ĒĒ‚ĒÄ‚ĒÄ README.md                  # This file

server.registerTool(
  "tool_name",
  {
    title: "Tool Title",
    description: "What the tool does",
    inputSchema: {
      param: z.string().describe("Parameter description"),
    },
    outputSchema: {
      result: z.string(),
    },
  },
  async ({ param }) => {
    try {
      // Tool implementation
      return {
        content: [{ type: "text", text: "Success message" }],
      };
    } catch (error: unknown) {
      const err = error as Error;
      return {
        content: [{ type: "text", text: `Error: ${err.message}` }],
        isError: true,
      };
    }
  }
);