QUICKSTART.md•2.91 kB
# Quick Start Guide
Get started with the Sequential Thinking MCP Server in minutes!
## Prerequisites
- Node.js 18+ installed
- npm or yarn package manager
## Installation
1. Clone or download the repository:
```bash
git clone <repository-url>
cd sequential-thinking-mvp-server
```
2. Install dependencies:
```bash
npm install
```
3. Build the project:
```bash
npm run build
```
## Quick Test
### Test 1: Run the Stdio Server
```bash
npm start
```
The server will start and wait for MCP protocol messages on stdin/stdout.
### Test 2: Run the HTTP Server
```bash
npm run start:http
```
Open http://localhost:3000 in your browser to see the server info.
Test with curl:
```bash
# Check health
curl http://localhost:3000/health
# Add a thought
curl -X POST http://localhost:3000/think \
-H "Content-Type: application/json" \
-d '{
"thought": "This is my first thought",
"nextThoughtNeeded": true,
"thoughtNumber": 1,
"totalThoughts": 3
}'
# Get sequence
curl http://localhost:3000/sequence
```
### Test 3: Deploy to Cloudflare Workers (Optional)
1. Install Wrangler CLI:
```bash
npm install -g wrangler
```
2. Login to Cloudflare:
```bash
wrangler login
```
3. Deploy:
```bash
npm run deploy:workers
```
## Use with Claude Desktop
1. Build the project:
```bash
npm run build
```
2. Find your config file location:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- Linux: `~/.config/Claude/claude_desktop_config.json`
3. Add the server to your config:
```json
{
"mcpServers": {
"sequential-thinking": {
"command": "node",
"args": ["/absolute/path/to/sequential-thinking-mvp-server/dist/index.js"]
}
}
}
```
4. Restart Claude Desktop
5. You should now see the sequential thinking tools available in Claude!
## Example Conversation with Claude
Once configured, try this with Claude:
```
You: Help me design a microservices architecture for an e-commerce platform.
Use sequential thinking to break down your reasoning.
Claude will then use the sequential_thinking tool to think through the problem step by step!
```
## Troubleshooting
### Server won't start
- Make sure you ran `npm run build` first
- Check that Node.js 18+ is installed: `node --version`
### Claude Desktop doesn't show the tools
- Verify the path in `claude_desktop_config.json` is absolute
- Check that the built files exist in the `dist/` directory
- Restart Claude Desktop completely
- Check Claude Desktop logs (Help > View Logs)
### HTTP server port already in use
- Change the port: `PORT=8080 npm run start:http`
## Next Steps
- Read the [README.md](README.md) for detailed documentation
- Check out the [examples](examples/) directory for client code
- Explore the source code in [src/](src/)
## Support
For issues or questions, please open an issue on GitHub.