My Simple MCP Client And Server

Ollama MCP代理

使用的Java CLI代理 奥拉玛 对于局部LLM推断， LangChain4j 对于编排， PicoCLI 对于命令行界面，以及 MCP（模型上下文协议） 用于工具集成。

包括一个提供随机报价的示例MCP服务器。

建筑

┌────────────────────────────────────────────────┐
│                   Agent                        │
│  ┌──────────┐  ┌────────────┐  ┌──────────┐    │
│  │ PicoCLI  │→ │ LangChain4j│→ │  Ollama  │    │
│  │ (CLI)    │  │ AiServices │  │  (LLM)   │    │
│  └──────────┘  └─────┬──────┘  └──────────┘    │
│                      │                         │
│               ┌──────┴──────┐                  │
│               │McpToolProvider│                │
│               └──────┬──────┘                  │
└──────────────────────┼─────────────────────────┘
                       │ STDIO
              ┌────────┴────────┐
              │  Quote Server   │
              │  (MCP Server)   │
              └─────────────────┘

先决条件

• Java 21 （LTS）
• Maven 3.x
• 奥拉玛 安装并运行模型（例如。， ollama pull llama3.2)

构建

cd ollama-mcp-agent
mvn clean package

这将构建所有三个模块，并为代理和报价服务器生成胖JAR。

用法

无需MCP即可运行代理（与Ollama直接聊天）

java -jar agent/target/agent-1.0.0-SNAPSHOT.jar

使用报价MCP服务器运行代理

java -jar agent/target/agent-1.0.0-SNAPSHOT.jar \
  --mcp-server "java -jar quote-server/target/quote-server-1.0.0-SNAPSHOT.jar"

然后询问报价：

You: Give me an inspirational quote
Assistant: "The future belongs to those who believe in the beauty of their dreams." — Eleanor Roosevelt [INSPIRATION]

CLI选项

例子

使用不同的模型：

java -jar agent/target/agent-1.0.0-SNAPSHOT.jar -m mistral

连接到远程Ollama实例：

java -jar agent/target/agent-1.0.0-SNAPSHOT.jar -u http://192.168.1.100:11434

多个MCP服务器：

java -jar agent/target/agent-1.0.0-SNAPSHOT.jar \
  --mcp-server "java -jar quote-server/target/quote-server-1.0.0-SNAPSHOT.jar" \
  --mcp-server "python my-other-server.py"

项目结构

ollama-mcp-agent/
├── pom.xml                  # Parent POM with dependency management
├── quote-common/            # Shared DTOs (Quote, QuoteCategory)
├── quote-server/            # MCP server providing random quotes
│   └── QuoteServerMain      #   Entry point (STDIO transport)
│   └── QuoteToolHandler     #   Tool definitions
│   └── InMemoryQuoteRepository  # 20 hardcoded quotes
└── agent/                   # CLI agent application
    ├── AgentCommand          #   PicoCLI entry point (Facade)
    ├── config/               #   Configuration (Builder pattern)
    ├── llm/                  #   LLM abstraction (Strategy pattern)
    ├── mcp/                  #   MCP client management
    ├── chat/                 #   Chat session and AI Services
    ├── event/                #   Event system (Observer pattern)
    └── io/                   #   Console I/O abstraction

设计模式

如何扩展

添加新的LLM提供程序

1. 实施 ChatModelProvider 接口
2. 更新 ChatModelProviderFactory 根据配置返回您的提供者

添加新的MCP服务器

1. 使用Java MCP SDK创建服务器（请参阅 quote-server 作为参考）
2. 通过 --mcp-server "command to start your server"

向报价服务器添加新工具

1. 添加新 SyncToolSpecification 在 QuoteToolHandler
2. 代理将通过MCP自动发现它

技术栈

ADR文件

• 001-多模块Maven结构
• 002-LangChain4j人工智能服务模式
• 003-STDIO MCP传输