命令行AI聊天工具

ANTHROPIC_API_KEY=""  # Enter your Anthropic API secret key

pip install uv

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

uv pip install -e .

uv run main.py

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

pip install anthropic python-dotenv prompt-toolkit "mcp[cli]==1.8.0"

python main.py

> What's the difference between async and await in Python?

> Summarize the key points in @deposition.md
> Compare @report.pdf with @outlook.pdf

> /summarize deposition.md
> /format_document plan.md

# Run with Git MCP server
python main.py servers/mcp_git_server.py

# Then in chat:
> Use git_status to show me what files have changed
> Use git_diff to show me the changes in detail
> Use git_log to show recent commits

# Run with File System MCP server
python main.py servers/mcp_filesystem_server.py

# Then in chat:
> Use read_file to show me the contents of main.py
> Use search_files to find all Python files
> Use list_directory to show what's in the core folder

# Run with Code Analysis MCP server
python main.py servers/mcp_code_analysis_server.py

# Then in chat:
> Use analyze_python_file to analyze core/chat.py
> Use find_todos to find all TODO comments
> Use count_lines to count lines in the core directory

# Run with Test Runner MCP server
python main.py servers/mcp_test_runner_server.py

# Then in chat:
> Use run_pytest to run all tests
> Use list_tests to show available tests

python main.py servers/mcp_git_server.py servers/mcp_filesystem_server.py servers/mcp_code_analysis_server.py

# Test your server in isolation
python main.py servers/mcp_database_server.py

# In chat, test each tool:
> Use db_query with sql="SELECT * FROM users LIMIT 5"
> Use db_schema with table="users"

# Debug issues without IDE complexity
# Iterate quickly on tool definitions

- name: Analyze code changes
  run: |
    echo "Use git_diff to show changes" | python main.py servers/mcp_git_server.py
    echo "Use find_todos to check for new TODOs" | python main.py servers/mcp_code_analysis_server.py
    echo "Use run_pytest with coverage=true" | python main.py servers/mcp_test_runner_server.py

# No GUI available, but need AI assistance
python main.py servers/mcp_filesystem_server.py

> Use search_files with pattern="**/*.log" to find all log files
> Use read_file with file_path="app.log" to check errors
> Analyze the error patterns and suggest fixes

# Students can see exactly what's happening
python main.py servers/mcp_git_server.py

# Watch the protocol in action
# See tool definitions
# Understand request/response flow

# Install dev dependencies
uv pip install -e ".[dev]"

# Run all tests
pytest

# Run with coverage
pytest --cov --cov-report=term-missing

# Run specific test file
pytest tests/test_config.py

# Format code with Black
black .

# Lint with Ruff
ruff check .

docs = {
    "your_doc.md": "Your document content here",
}

from pydantic import Field
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("CustomMCP", log_level="ERROR")

@mcp.tool(
    name="your_tool",
    description="Description of what your tool does",
)
def your_tool(
    param: str = Field(description="Parameter description")
) -> str:
    """Tool implementation."""
    return f"Result: {param}"

if __name__ == "__main__":
    mcp.run(transport="stdio")

python main.py servers/mcp_custom_server.py

mcp-chat/
├── core/                 # Core application modules
│   ├── chat.py           # Core chat logic
│   ├── claude.py         # Claude API wrapper
│   ├── cli.py            # CLI interface
│   ├── cli_chat.py       # CLI-specific chat features
│   ├── config.py         # Configuration management
│   ├── exceptions.py     # Custom exceptions
│   ├── logger.py         # Logging setup
│   └── tools.py          # Tool execution
├── servers/              # MCP servers
│   ├── mcp_server.py     # Document server
│   ├── mcp_git_server.py # Git operations
│   ├── mcp_filesystem_server.py  # File system
│   ├── mcp_code_analysis_server.py  # Code analysis
│   └── mcp_test_runner_server.py   # Test runner
├── tests/                # Test suite
├── docs/                 # Documentation
│   ├── HONEST_ASSESSMENT.md  # When to use this tool
│   ├── QUICK_START.md    # 5-minute setup
│   ├── ARCHITECTURE.md   # Technical details
│   └── CONTRIBUTING.md   # Development guide
├── main.py               # Application entry point
├── mcp_client.py         # MCP client implementation
└── README.md             # This file

ANTHROPIC_API_KEY="your-actual-api-key"

uv pip install -e ".[dev]"

LOG_LEVEL=DEBUG python main.py